JumpListItem Classe

Definizione

Spazio dei nomi:

Windows.UI.StartScreen

Fornisce funzionalità per la creazione e la definizione di elementi jump list per l'elenco di jump list di un'app.

public ref class JumpListItem sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 131072)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class JumpListItem final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 131072)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class JumpListItem

Public NotInheritable Class JumpListItem

Ereditarietà

Object Platform::Object IInspectable JumpListItem

Attributi

ContractVersionAttribute MarshalingBehaviorAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10586.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v2.0)

Esempio

Nell'esempio seguente viene illustrato come creare un'attività per jumplist che avvia l'app con parametri della riga di comando e esegue un'azione desiderata. La localizzazione non viene visualizzata, ma è possibile per DisplayName, description e logo tramite l'uso degli schemi ms-resource: e ms-appx: URI.

private Windows.UI.StartScreen.JumpListItem CreateJumpListItemTask()
{
    var taskItem = JumpListItem.CreateWithArguments(
                            "/Argument", "DisplayName");

    // Set the description. (Optional.)
    taskItem.Description = "Compose a new message to " + friendName;

    // Set the logo for this jump list item. Must be ms-appx: or ms-appdata:.
    taskItem.Logo = new Uri("ms-appdata:///local/downloads/taskImage.png");

    // If the GroupName is left blank, then the item goes into the Tasks group by default.

    return taskItem;
}

partial class App
{
    protected override void OnLaunched(LaunchActivatedEventArgs e)
    {
        if (e.Kind == ActivationKind.Launch && e.Arguments == "/Argument")
        {
            // Run code relevant to the task that was selected.
        }
    }
}

Commenti

Viene creato un JumpListItem usando i metodi CreateWithArguments e CreateSeparator . Dopo la creazione, possono essere aggiunti all'elenco di jump list dell'app usando la proprietà Items dell'elenco jump e il metodo SaveAsync . Tenere presente che nell'interfaccia utente un utente può fare clic con il pulsante destro del mouse su un elemento jump list che si trova in un gruppo personalizzato e selezionare "Rimuovi da questo elenco". Quando si verifica questa azione, il sistema contrassegna l'elemento come rimosso dall'utente e lo elimina dall'interfaccia utente. La prossima volta che un'app carica l'elenco di jump, deve controllare gli elementi per verificare se la proprietà RemovedByUser dell'elemento è impostata su True. Se RemovedByUser è True, l'app deve aggiornare lo stato interno da sincronizzare con la modifica avviata dall'utente. È responsabilità delle app assicurarsi che un elemento rimosso non venga aggiunto nuovamente all'elenco jump fino a quando non vengono soddisfatte nuovamente le condizioni per l'aggiunta, ad esempio, dall'utente che apre nuovamente il documento associato.

Quando un'app salva JumpList usando SaveAsync, il sistema operativo organizza gli elementi come indicato di seguito.

• Tutti gli elementi con RemovedByUser uguale a True vengono rimossi.
• Gli elementi con la stessa proprietà GroupName vengono inseriti insieme, mantenendo l'ordine relativo.
• I gruppi vengono ordinati in base alla posizione originale del primo elemento del gruppo, con l'eccezione che i gruppi gestiti dal sistema sono sempre nella parte superiore e il gruppo Attività è sempre nella parte inferiore se presenti. Ciò significa che quando un'app carica jumpList usando il metodo LoadCurrentAsync , gli elementi vengono recuperati nell'ordine organizzato, che potrebbero non accettare l'ordine degli elementi nell'elenco jump quando è stato salvato originariamente.

Proprietà

Arguments	Ottiene gli argomenti della riga di comando per l'elemento jump list.
Description	Ottiene o imposta la descrizione dell'attività dell'elemento jump list.
DisplayName	Ottiene o imposta il nome visualizzato dell'elemento jump list. Il nome visualizzato può essere specificato anche come parametro usando il metodo CreateWithArguments quando viene creata l'elemento jump list.
GroupName	Ottiene o imposta il nome del gruppo personalizzato dell'elemento jump list. Se non viene specificato alcun nome, l'elemento verrà aggiunto al gruppo Attività per impostazione predefinita.
Kind	Ottiene JumpListItemKind di un elemento jump list.
Logo	Ottiene o imposta il logo dell'elemento jump list.
RemovedByUser	Ottiene un valore booleano che indica se l'elemento jump list è stato rimosso dall'elenco di jump list dell'app dall'utente.

Metodi

CreateSeparator()	Crea un elemento jump list che è un separatore inert per un gruppo personalizzato all'interno dell'elenco di jump list dell'app.
CreateWithArguments(String, String)	Crea un nuovo elemento jump list per l'elenco di jump list di un'app.

Vedi anche

• Esempio di personalizzazione di Jump list