Partilhar via

Classe JumpList

  • Artigo

Representa uma lista de itens e tarefas exibidas como um menu em uma Windows 7 botão da barra de tarefas.

Hierarquia de herança

System.Object
  Microsoft.Windows.Shell.JumpList

Namespace:  Microsoft.Windows.Shell
Assembly:  Microsoft.Windows.Shell (em Microsoft.Windows.Shell.dll)

Sintaxe

'Declaração
<ContentPropertyAttribute("JumpItems")> _
Public NotInheritable Class JumpList _
    Implements ISupportInitialize

[ContentPropertyAttribute("JumpItems")]
public sealed class JumpList : ISupportInitialize

[ContentPropertyAttribute(L"JumpItems")]
public ref class JumpList sealed : ISupportInitialize

[<Sealed>]
[<ContentPropertyAttribute("JumpItems")>]
type JumpList =  
    class
        interface ISupportInitialize
    end

public final class JumpList implements ISupportInitialize

O tipo JumpList expõe os membros a seguir.

Construtores

  Nome Descrição
Método público JumpList() Initializes a new instance of the JumpList class.
Método público JumpList(IEnumerable<JumpItem>, Boolean, Boolean) Inicializa uma nova instância de JumpList classe com parâmetros especificados.

Início

Propriedades

  Nome Descrição
Propriedade pública JumpItems Obtém a coleção de JumpItem os objetos que são exibidos na lista de salto.
Propriedade pública ShowFrequentCategory Obtém ou define um valor que indica se os itens usados com freqüência são exibidas na lista de saltos.
Propriedade pública ShowRecentCategory Obtém ou define um valor que indica se os itens usados recentemente são exibidos na lista de saltos.

Início

Métodos

  Nome Descrição
Método públicoMembro estático AddToRecentCategory(String) Adiciona o caminho do item especificado para o recentes categoria da lista de saltos.
Método públicoMembro estático AddToRecentCategory(JumpPath) Adiciona o caminho de salto especificado para o recentes categoria da lista de saltos.
Método públicoMembro estático AddToRecentCategory(JumpTask) Adiciona a tarefa de salto especificado para o recentes categoria da lista de saltos.
Método público Apply Envia o JumpList ao shell do Windows no seu estado atual.
Método público BeginInit Infraestrutura. Sinaliza o início do JumpList a inicialização.
Método público EndInit Infraestrutura. Sinaliza o fim do JumpList a inicialização.
Método público Equals Determina se o especificado Object é igual a atual Object. (Herdado de Object.)
Método protegido Finalize Permite que um objeto tentar liberar recursos e executar outras operações de limpeza antes que ele é recuperado pela coleta de lixo. (Herdado de Object.)
Método público GetHashCode Serves as a hash function for a particular type. (Herdado de Object.)
Método públicoMembro estático GetJumpList Retorna o JumpList objeto associado com um aplicativo.
Método público GetType Obtém o Type da instância atual. (Herdado de Object.)
Método protegido MemberwiseClone Cria uma cópia superficial do atual Object. (Herdado de Object.)
Método públicoMembro estático SetJumpList Conjuntos de JumpList objeto associado com um aplicativo.
Método público ToString Retorna um string que representa o objeto atual. (Herdado de Object.)

Início

Eventos

  Nome Descrição
Evento público JumpItemsRejected Ocorre quando os itens de salto não são adicionados com êxito para a lista de saltos pelo shell do Windows.
Evento público JumpItemsRemovedByUser Ocorre quando os itens de salto anteriormente na lista de saltos são removidos da lista pelo usuário.

Início

Comentários

O Windows 7 barra de tarefas fornece funcionalidade aprimorada para iniciar programas diretamente a partir do botão da barra de tarefas, usando listas de salto. As listas de saltos também são usadas na Windows 7 Start menu. Você pode acessar uma lista de saltos clicando 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 saltos, consulte o barra de tarefas seção Diretrizes de interação da experiência de usuário do Windows.

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

A ilustração a seguir mostra o salto lista para Windows Media Player, com itens de tarefas e freqüentes categorias.

Windows Media Player Jump List

Lista de Atalhos do Windows Media Player

Configurando uma lista de salto

Jump Lists podem conter dois tipos de itens, um JumpTask e um JumpPath. A JumpTask é um link para um programa e um JumpPath é um link para um arquivo. Você pode separar visualmente os itens em uma lista de atalhos, criando uma JumpTask não tem um Title e CustomCategory especificado. Esta vazio JumpTask será exibido como uma linha horizontal na lista de salto.

Observação

Se o tipo do arquivo especificado em um JumpPath não está registrado com o seu aplicativo, o arquivo não será exibido na lista de salto.Por exemplo, se você adicionar um JumpPath que aponta para um arquivo. txt, seu aplicativo deve ser registrado para lidar com todos os arquivos. txt.Para obter mais informações, consulte Introdução às associações de arquivo.

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

Você pode especificar se o padrão recentes e freqüentes categorias são exibidas na JumpList , definindo a ShowRecentCategory e ShowFrequentCategory Propriedades. O conteúdo dessas categorias é gerenciado pelo Windows shell. Porque essas categorias podem conter muitos dos mesmos dados, você normalmente exibe um ou outro em seu JumpList, mas não ambos. Windowsgerencia automaticamente os itens recentes, se eles forem abertos por meio de uma caixa de diálogo comum de arquivo ou usados para abrir um aplicativo por meio da associação de tipo de arquivo. Quando um item é acessado através da lista de saltos, você pode notificar o Windows shell para adicionar o item para o recentes categoria chamando o AddToRecentCategory método.

A aplicação de uma lista de saltos para o Shell do Windows

Não é possível acessar a lista de atalhos do shell diretamente ou ler seu conteúdo para o JumpList classe. Em vez disso, o JumpList classe fornece uma representação de uma lista de atalhos que você pode trabalhar com e em seguida, aplique a Windows shell. Você normalmente cria uma JumpList e defini-la uma vez quando o aplicativo é executar primeiro. No entanto, você pode modificar ou substituir o JumpList em tempo de execução.

Quando você tiver definido a JumpList Propriedades, você deve aplicar o JumpList ao shell do Windows antes de seu conteúdo são exibidos na barra de tarefas lista de salto. Isso é feito automaticamente quando o JumpList primeiro anexado a um aplicativo, em XAML ou em uma chamada para o SetJumpList método. Se você modificar o conteúdo de JumpList em tempo de execução, você deve chamar o Apply método para aplicar o conteúdo atual do shell do Windows.

A definição de uma lista de saltos em XAML

A JumpList não é automaticamente anexado a uma Application objeto. Você pode anexar um JumpList para um Application o objeto em XAML usando a sintaxe da propriedade anexada. O JumpList classe implementa o ISupportInitialize interface para oferecer suporte a declaração de XAML de um JumpList. Se o JumpList está declarado no XAML e conectado ao atual Application, será aplicada automaticamente à Windows shell quando o JumpList é inicializada.

Definir e modificar uma lista de saltos no código

Você pode anexar um JumpList para um Application objeto no código, chamando o estático SetJumpList método. Isso também se aplica a JumpList para o Windows shell.

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

Observação

Você normalmente cria um JumpList anexado ao Application e aplicado a Windows shell.No entanto, você pode criar várias JumpList objetos.Apenas um JumpList cada vez pode ser aplicado ao Windows shell e apenas uma JumpList ao mesmo tempo podem ser associados a um Application.A.NET Framework não exige que essas sejam as mesmas JumpList.

Observação

Essa classe contém uma demanda de link no nível de classe que se aplica a todos os membros.A SecurityException é lançada quando o chamador imediato não tiver permissão de confiança total.Para obter mais informações sobre as exigências de segurança, consulte Demandas de link e Demandas de herança.

Segurança do .NET Framework

Acesso thread-safe

Quaisquer membros static (Shared no Visual Basic) públicos deste tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Consulte também

Referência

Namespace Microsoft.Windows.Shell