Partilhar via


JumpList Classe

Definição

Fornece funcionalidade para a lista de atalhos de um aplicativo. Uma lista de atalhos é um menu fornecido pelo sistema que aparece quando o usuário clica com o botão direito do mouse em um programa na barra de tarefas ou no menu Iniciar. Ele é usado para fornecer acesso rápido a documentos usados recentemente ou com frequência e oferecer links diretos para a funcionalidade do aplicativo. Nem todas as famílias de dispositivos dão suporte a listas de atalhos.

public ref class JumpList sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 131072)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class JumpList final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 131072)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class JumpList
Public NotInheritable Class JumpList
Herança
Object Platform::Object IInspectable JumpList
Atributos

Requisitos do Windows

Família de dispositivos
Windows 10 (introduzida na 10.0.10586.0)
API contract
Windows.Foundation.UniversalApiContract (introduzida na v2.0)

Exemplos

O exemplo a seguir demonstra como remover a lista de atalhos de um aplicativo, incluindo quaisquer itens personalizados que possam ter sido adicionados anteriormente.

private async void DisableSystemJumpListAsync()
{
    // Get the app's jump list.
    var jumpList = await Windows.UI.StartScreen.JumpList.LoadCurrentAsync();

    // Disable the system-managed jump list group.
    jumpList.SystemGroupKind = Windows.UI.StartScreen.JumpListSystemGroupKind.None;

    // Remove any previously added custom jump list items.
    jumpList.Items.Clear();

    // Save the changes to the app's jump list.
    await jumpList.SaveAsync();
}

O exemplo a seguir demonstra como definir o tipo de grupo gerenciado pelo sistema usado pela lista de atalhos de um aplicativo, sem afetar os itens de lista de atalhos personalizados existentes.

private async void SetSystemGroupAsync()
{
    // Get the app's jump list.
    var jumpList = await Windows.UI.StartScreen.JumpList.LoadCurrentAsync();

    // Set the system to autogenerate a Frequent group for the app jump list.
    // Alternatively, this property could be set to JumpListSystemGroupKind.Recent to autogenerate a Recent group.
    jumpList.SystemGroupKind = Windows.UI.StartScreen.JumpListSystemGroupKind.Frequent;

    // No changes were made to the jump list Items property, so any custom tasks and groups remain intact.
    await jumpList.SaveAsync();
}

Comentários

O JumpList de um aplicativo é recuperado usando o método LoadCurrentAsync . Se um aplicativo não personalizar sua lista de atalhos, o sistema fornecerá uma lista de atalhos padrão. Atualmente, a lista de atalhos padrão mostra itens recentes. Verifique se o aplicativo se registrou para se tornar o manipulador de arquivos padrão para um determinado tipo de arquivo que você deseja mostrar na lista de itens recentes. Para obter mais informações, consulte Manipular ativação de arquivo.

Propriedades

Items

Obtém a lista de JumpListItems para a lista de atalhos. Itens é do tipo IVector(JumpListItem).

SystemGroupKind

Obtém ou define o tipo atual do grupo de lista de atalhos gerenciado pelo sistema.

Métodos

IsSupported()

Obtém um valor que indica se o sistema dá suporte a listas de atalhos.

Observação

Somente a família de dispositivos da área de trabalho dá suporte a listas de atalhos, as alterações feitas em uma lista de atalhos com uma família de dispositivos diferente não persistirão.

LoadCurrentAsync()

Recupera de forma assíncrona a lista de atalhos atual e seus itens.

SaveAsync()

Salva as alterações de forma assíncrona na lista de atalhos e em seus itens.

Aplica-se a

Confira também