JumpList Classe

Definição

public ref class JumpList sealed : System::ComponentModel::ISupportInitialize

[System.Windows.Markup.ContentProperty("JumpItems")]
public sealed class JumpList : System.ComponentModel.ISupportInitialize

[System.Windows.Markup.ContentProperty("JumpItems")]
[System.Security.SecurityCritical]
public sealed class JumpList : System.ComponentModel.ISupportInitialize

[<System.Windows.Markup.ContentProperty("JumpItems")>]
type JumpList = class
    interface ISupportInitialize

[<System.Windows.Markup.ContentProperty("JumpItems")>]
[<System.Security.SecurityCritical>]
type JumpList = class
    interface ISupportInitialize

Public NotInheritable Class JumpList
Implements ISupportInitialize

Herança

Object

JumpList

Atributos

ContentPropertyAttribute SecurityCriticalAttribute

Implementações

ISupportInitialize

Exemplos

O exemplo a seguir mostra um aplicativo com uma Lista de Atalhos. O aplicativo tem três botões que permitem adicionar uma tarefa à Lista de Atalhos atual, limpar o conteúdo da Lista de Atalhos e aplicar uma nova Lista de Atalhos ao aplicativo.

O exemplo a seguir mostra como declarar um JumpList na marcação. O JumpList contém dois JumpTask links e um JumpPath. A aplicação do JumpPath ao shell falhará se o aplicativo não estiver registrado para manipular a extensão de nome de arquivo .txt.

<Application x:Class="JumpListSample.App"
             xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
             StartupUri="MainWindow.xaml">
    <JumpList.JumpList>
        <JumpList ShowRecentCategory="True"
                  ShowFrequentCategory="True"
                  JumpItemsRejected="JumpList_JumpItemsRejected"
                  JumpItemsRemovedByUser="JumpList_JumpItemsRemovedByUser">
            <JumpTask Title="Notepad" 
                      Description="Open Notepad." 
                      ApplicationPath="C:\Windows\notepad.exe"
                      IconResourcePath="C:\Windows\notepad.exe"/>
            <JumpTask Title="Read Me" 
                      Description="Open readme.txt in Notepad." 
                      ApplicationPath="C:\Windows\notepad.exe"
                      IconResourcePath="C:\Windows\System32\imageres.dll"
                      IconResourceIndex="14"
                      WorkingDirectory="C:\Users\Public\Documents"
                      Arguments="readme.txt"/>
            <JumpPath Path="C:\Users\Public\Documents\readme.txt" />
        </JumpList>
    </JumpList.JumpList>
</Application>

O exemplo a seguir mostra a página code-behind para App.xaml. Esse código manipula os JumpItemsRejected eventos e JumpItemsRemovedByUser .

using System.Text;
using System.Windows;
using System.Windows.Shell;

namespace JumpListSample
{
    /// <summary>
    /// Interaction logic for App.xaml
    /// </summary>
    public partial class App : Application
    {
        private void JumpList_JumpItemsRejected(object sender, System.Windows.Shell.JumpItemsRejectedEventArgs e)
        {
            StringBuilder sb = new StringBuilder();
            sb.AppendFormat("{0} Jump Items Rejected:\n", e.RejectionReasons.Count);
            for (int i = 0; i < e.RejectionReasons.Count; ++i)
            {
                if (e.RejectedItems[i].GetType() == typeof(JumpPath))
                    sb.AppendFormat("Reason: {0}\tItem: {1}\n", e.RejectionReasons[i], ((JumpPath)e.RejectedItems[i]).Path);
                else
                    sb.AppendFormat("Reason: {0}\tItem: {1}\n", e.RejectionReasons[i], ((JumpTask)e.RejectedItems[i]).ApplicationPath);
            }

            MessageBox.Show(sb.ToString());
        }

        private void JumpList_JumpItemsRemovedByUser(object sender, System.Windows.Shell.JumpItemsRemovedEventArgs e)
        {
            StringBuilder sb = new StringBuilder();
            sb.AppendFormat("{0} Jump Items Removed by the user:\n", e.RemovedItems.Count);
            for (int i = 0; i < e.RemovedItems.Count; ++i)
            {
                sb.AppendFormat("{0}\n", e.RemovedItems[i]);
            }

            MessageBox.Show(sb.ToString());
        }
    }
}

O exemplo a seguir mostra a marcação usada para criar a interface do usuário do aplicativo.

<Window x:Class="JumpListSample.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        Title="Jump List Sample" Height="240" Width="500">
    <Window.Resources>
        <Style TargetType="Button">
            <Setter Property="Width" Value="200" />
            <Setter Property="Margin" Value="5" />
        </Style>
    </Window.Resources>
    <Grid>
        <StackPanel>
            <Button Content="Add Task to JumpList" Click="AddTask" />
            <Button Content="Clear Jump List" Click="ClearJumpList"/>
            <Button Content="Set New Jump List" Click="SetNewJumpList" />
        </StackPanel>
    </Grid>
</Window>

O exemplo a seguir mostra a página code-behind para MainWindow.xaml. Esse código demonstra como modificar, limpar e criar um JumpList no código de procedimento. Para a nova Lista de Atalhos, o método estático SetJumpList é chamado para associar o JumpList ao aplicativo atual e aplicar o JumpList ao shell do Windows.

using System;
using System.IO;
using System.Windows;
using System.Windows.Shell;

namespace JumpListSample
{
    /// <summary>
    /// Interaction logic for MainWindow.xaml
    /// </summary>
    public partial class MainWindow : Window
    {
        public MainWindow()
        {
            InitializeComponent();
        }
        private void AddTask(object sender, RoutedEventArgs e)
        {
            // Configure a new JumpTask.
            JumpTask jumpTask1 = new JumpTask();
            // Get the path to Calculator and set the JumpTask properties.
            jumpTask1.ApplicationPath = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.SystemX86), "calc.exe");
            jumpTask1.IconResourcePath = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.SystemX86), "calc.exe");
            jumpTask1.Title = "Calculator";
            jumpTask1.Description = "Open Calculator.";
            jumpTask1.CustomCategory = "User Added Tasks";
            // Get the JumpList from the application and update it.
            JumpList jumpList1 = JumpList.GetJumpList(App.Current);
            jumpList1.JumpItems.Add(jumpTask1);
            JumpList.AddToRecentCategory(jumpTask1);
            jumpList1.Apply();
        }
        private void ClearJumpList(object sender, RoutedEventArgs e)
        {
            JumpList jumpList1 = JumpList.GetJumpList(App.Current);
            jumpList1.JumpItems.Clear();
            jumpList1.Apply();
        }
        private void SetNewJumpList(object sender, RoutedEventArgs e)
        {
            //Configure a new JumpTask
            JumpTask jumpTask1 = new JumpTask();
            // Get the path to WordPad and set the JumpTask properties.
            jumpTask1.ApplicationPath = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.System), "write.exe");
            jumpTask1.IconResourcePath = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.System), "write.exe");
            jumpTask1.Title = "WordPad";
            jumpTask1.Description = "Open WordPad.";
            jumpTask1.CustomCategory = "Jump List 2";
            // Create and set the new JumpList.
            JumpList jumpList2 = new JumpList();
            jumpList2.JumpItems.Add(jumpTask1);
            JumpList.SetJumpList(App.Current, jumpList2);
        }
    }
}

Comentários

A barra de tarefas do Windows 7 fornece funcionalidade aprimorada para iniciar programas diretamente do botão da barra de tarefas usando Listas de Atalhos. Listas de Atalhos também são usadas no menu Iniciar do Windows 7. Você acessa uma Lista de Atalhos clicando com o botão direito do mouse em um botão da barra de tarefas ou clicando na seta ao lado de um programa no menu Iniciar. Para obter mais informações sobre Listas de Atalhos, consulte a seção Barra de tarefas das Diretrizes de Interação da Experiência do Usuário do Windows.

A JumpList classe fornece um wrapper gerenciado para a funcionalidade Lista de Atalhos na barra de tarefas do Windows 7 e gerencia os dados passados para o shell do Windows. A funcionalidade exposta pela JumpList classe não está disponível em versões do Windows anteriores ao Windows 7. Os aplicativos que usam a JumpList classe serão executados em outras versões do Windows, mas a Lista de Atalhos não estará disponível. Para obter mais informações sobre o shell do Windows e as APIs nativas da Lista de Atalhos, consulte Extensões da barra de tarefas.

A ilustração a seguir mostra a Lista de Atalhos para Windows Media Player, com itens nas categorias Tarefas e Frequentes .

Lista de jump
Lista de Atalhos do Windows Media Player

Configurando uma lista de atalhos

Listas de Atalhos podem conter dois tipos de itens, um JumpTask e um JumpPath. Um JumpTask é um link para um programa e um JumpPath é um link para um arquivo. Você pode separar visualmente itens em uma Lista de Atalhos criando um JumpTask que não tem um Title e CustomCategory especificado. Esse vazio JumpTask será exibido como uma linha horizontal na Lista de Atalhos.

Os itens de salto são colocados em categorias no JumpList. Por padrão, um JumpItem é exibido na categoria Tarefas . Como alternativa, você pode especificar um CustomCategory para o JumpItem.

Você pode especificar se as categorias padrão Recentes e Frequentes são exibidas no JumpList definindo as ShowRecentCategory propriedades e ShowFrequentCategory . O conteúdo dessas categorias é gerenciado pelo shell do Windows. Como essas categorias podem conter muitos dos mesmos dados, normalmente você exibe um ou outro em seu JumpList, mas não ambos. O Windows gerencia automaticamente itens recentes se eles são abertos por meio de uma caixa de diálogo de arquivo comum ou usados para abrir um aplicativo por meio da associação de tipo de arquivo. Quando um item é acessado por meio da Lista de Atalhos, você pode notificar o shell do Windows para adicionar o item à categoria Recente chamando o AddToRecentCategory método .

Aplicando uma lista de atalhos ao Shell do Windows

Você não pode acessar a Lista de Atalhos do shell diretamente ou ler seu conteúdo na JumpList classe . Em vez disso, a JumpList classe fornece uma representação de uma Lista de Atalhos com a qual você pode trabalhar e, em seguida, aplica-se ao shell do Windows. Normalmente, você cria um JumpList e o define uma vez quando o aplicativo é executado pela primeira vez. No entanto, você pode modificar ou substituir o JumpList em tempo de execução.

Quando você tiver definido as JumpList propriedades, deverá aplicar o JumpList ao shell do Windows antes que seu conteúdo apareça na lista de atalhos da barra de tarefas. Isso é feito automaticamente quando o JumpList é anexado pela primeira vez a um aplicativo, seja em XAML ou em uma chamada para o SetJumpList método . Se você modificar o conteúdo do em tempo de JumpList execução, deverá chamar o Apply método para aplicar seu conteúdo atual ao shell do Windows.

Definindo uma lista de atalhos em XAML

Um JumpList não é anexado automaticamente a um Application objeto . Você anexa um a um JumpListApplication objeto em XAML usando a sintaxe da propriedade anexada. A JumpList classe implementa a ISupportInitialize interface para dar suporte à declaração XAML de um JumpList. Se o JumpList for declarado em XAML e anexado ao atual Application, ele será aplicado automaticamente ao shell do Windows quando o JumpList for inicializado.

Configurando e modificando uma lista de atalhos no código

Você anexa um a um JumpListApplication objeto no código chamando o método estático SetJumpList . Isso também aplica o JumpList ao shell do Windows.

Para modificar um JumpList em tempo de execução, chame o GetJumpList método para obter o JumpList que está atualmente anexado a um Application. Depois de modificar as propriedades do JumpList, você deve chamar o Apply método para aplicar as alterações ao shell do Windows.

Construtores

Propriedades

Métodos

Eventos

Aplica-se a