Aggiungi elementi alla Jump List di Windows

Un jump list è il menu di scelta rapida visualizzato Windows quando un utente fa clic con il pulsante destro del mouse sull'icona dell'app sulla barra delle applicazioni o nel menu Start. È possibile popolare la jump list con attività , azioni rapide a livello di app, ad esempio la composizione di un nuovo messaggio o le impostazioni di apertura, e con gruppi personalizzati di elementi, ad esempio progetti recenti o documenti aggiunti.

Aprire l'app Raccolta WinUI e vedere JumpList in azione

Importante

L'API JumpList richiede l'identità del pacchetto. Funziona nelle app in pacchetto (MSIX) e nelle app pacchettizzate con posizione esterna, ma non è disponibile nelle app senza pacchetto.

Prerequisiti

Caricare la jump list corrente

Prima di aggiungere o rimuovere elementi, caricare la jump list corrente dell'app chiamando JumpList.LoadCurrentAsync:

using Windows.UI.StartScreen;

var jumpList = await JumpList.LoadCurrentAsync();

Aggiungere attività

Le attività sono elementi con una proprietà GroupName vuota. Windows li inserisce in una sezione Attività predefinita nella parte inferiore della jump list. Usare le attività per le azioni comuni che sono sempre rilevanti indipendentemente dal contesto.

Creare un'attività con JumpListItem.CreateWithArguments, aggiungerla all'insieme Items e quindi salvarla chiamando JumpList.SaveAsync. Quando l'utente seleziona l'attività, Windows avvia l'app con la stringa di argomento specificata, che è possibile leggere dagli argomenti di attivazione all'avvio.

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();

Aggiungere elementi a un gruppo personalizzato

I gruppi personalizzati consentono di organizzare gli elementi correlati in un'intestazione denominata. Impostare la proprietà GroupName su una stringa non vuota; tutti gli elementi che condividono lo stesso GroupName vengono visualizzati insieme sotto tale intestazione.

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();

Cancella tutti gli elementi

Per rimuovere tutti gli elementi aggiunti, deselezionare la raccolta Items prima di salvare:

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

Windows mantiene le sezioni gestite dal sistema ,ad esempio Recenti e Frequenti, indipendentemente da questa chiamata. Vengono cancellate solo le attività e i gruppi personalizzati.

  • Last updated on