Adicionar itens à lista de salto do Windows

Uma lista de salto é o menu de atalhos que o Windows mostra quando um utilizador clica com o botão direito no ícone da sua aplicação na barra de tarefas ou no menu Iniciar. Pode preencher a lista de salto com tarefas — ações rápidas em toda a aplicação, como compor uma nova mensagem ou abrir definições — e com grupos personalizados de itens, como projetos recentes ou documentos fixados.

Abra a aplicação WinUI Gallery e veja a JumpList em ação

Importante

A API JumpList requer identidade de pacote. Funciona em aplicações empacotadas (MSIX) e aplicações com localização externa, mas não está disponível em aplicações não empacotadas.

Prerequisites

Carregar a lista de saltos atual

Antes de adicionar ou remover itens, carregue a lista de salto atual da aplicação chamando JumpList.LoadCurrentAsync:

using Windows.UI.StartScreen;

var jumpList = await JumpList.LoadCurrentAsync();

Adicionar tarefas

As tarefas são itens com a propriedade GroupName vazia. O Windows coloca-os numa secção de Tarefas incorporada no final da lista de saltos. Use tarefas para ações comuns que sejam sempre relevantes independentemente do contexto.

Crie uma tarefa com JumpListItem.CreateWithArguments, adicione-a à coleção Itens e depois guarde chamando JumpList.SaveAsync. Quando o utilizador seleciona a tarefa, o Windows inicia a sua aplicação com a cadeia de argumentos que forneceu, que pode ler nos argumentos de ativação no arranque.

var jumpList = await JumpList.LoadCurrentAsync();

var task = JumpListItem.CreateWithArguments("/compose", "New Message");
task.Description = "Compose a new message";
task.Logo = new Uri("ms-appx:///Assets/Tiles/AppList.targetsize-48.png");

jumpList.Items.Add(task);
await jumpList.SaveAsync();

Adicionar itens a um grupo personalizado

Grupos personalizados permitem-lhe organizar itens relacionados sob um título nomeado. Defina a propriedade GroupName para uma string não vazia; todos os itens que partilham o GroupName mesmo aparecem juntos sob esse título.

var jumpList = await JumpList.LoadCurrentAsync();

var item = JumpListItem.CreateWithArguments("/project-alpha", "Project Alpha");
item.GroupName = "Projects";
item.Description = "Open Project Alpha";
item.Logo = new Uri("ms-appx:///Assets/Tiles/AppList.targetsize-48.png");

jumpList.Items.Add(item);
await jumpList.SaveAsync();

Limpar todos os itens

Para remover todos os itens que adicionou, limpe a coleção de Itens antes de guardar:

var jumpList = await JumpList.LoadCurrentAsync();
jumpList.Items.Clear();
await jumpList.SaveAsync();

O Windows preserva as secções geridas pelo sistema (como Recente e Frequente) independentemente desta chamada; apenas as suas tarefas e grupos personalizados são eliminados.

  • Last updated on