JumpList Classe

Definizione

Spazio dei nomi:

Windows.UI.StartScreen

Fornisce funzionalità per l'elenco di jump list di un'app. Un elenco di jump è un menu fornito dal sistema visualizzato quando l'utente fa clic con il pulsante destro del mouse su un programma nella barra delle applicazioni o nel menu Start. Viene usato per fornire accesso rapido ai documenti usati di recente o di frequente e offrire collegamenti diretti alle funzionalità dell'app. Non tutte le famiglie di dispositivi supportano gli elenchi di salto.

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

Ereditarietà

Object Platform::Object IInspectable JumpList

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 rimuovere l'elenco di jump per un'app, inclusi gli elementi personalizzati che potrebbero essere stati aggiunti in precedenza.

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

Nell'esempio seguente viene illustrato come impostare il tipo di gruppo gestito dal sistema usato dall'elenco jump list di un'app, senza influire sugli elementi di jump list personalizzati esistenti.

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

Commenti

Il jumplist di un'app viene recuperato usando il metodo LoadCurrentAsync . Se un'applicazione non personalizza l'elenco di jump list, il sistema fornisce un elenco jump list predefinito. Attualmente, l'elenco jump predefinito mostra elementi recenti. Assicurarsi che l'app sia registrata per diventare il gestore di file predefinito per un determinato tipo di file da visualizzare nell'elenco degli elementi recenti. Per altre informazioni, vedere Gestire l'attivazione dei file.

Proprietà

Items	Ottiene l'elenco di JumpListItem per l'elenco di jump list. Gli elementi sono di tipo IVector(JumpListItem).
SystemGroupKind	Ottiene o imposta il tipo corrente del gruppo di jump list gestito dal sistema.

Metodi

IsSupported()	Ottiene un valore che indica se il sistema supporta gli elenchi di salto. Nota Solo la famiglia di dispositivi desktop supporta i jump list, le modifiche apportate a un elenco jump con una famiglia di dispositivi diversa non verranno mantenute.
LoadCurrentAsync()	Recupera in modo asincrono l'elenco jump corrente e i relativi elementi.
SaveAsync()	Salva in modo asincrono le modifiche apportate all'elenco jump e ai relativi elementi.

Vedi anche

• Esempio di personalizzazione di Jump list