JumpListItem Classe

Definizione

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

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à

Metodi

Si applica a

Vedi anche

• Esempio di personalizzazione di Jump list