Freigeben über

JumpList Klasse

  • Referenz

Definition

Namespace:
Windows.UI.StartScreen
Bearbeiten

Stellt Funktionen für die Sprungliste einer App bereit. Eine Sprungliste ist ein vom System bereitgestelltes Menü, das angezeigt wird, wenn der Benutzer mit der rechten Maustaste auf ein Programm in der Taskleiste oder im Startmenü klickt. Es wird verwendet, um schnellen Zugriff auf kürzlich oder häufig verwendete Dokumente zu ermöglichen und direkte Links zur App-Funktionalität bereitzustellen. Nicht alle Gerätefamilien unterstützen Sprunglisten.

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
Vererbung
Object Platform::Object IInspectable JumpList
Attribute
ContractVersionAttribute MarshalingBehaviorAttribute

Windows-Anforderungen

Gerätefamilie
Windows 10 (eingeführt in 10.0.10586.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v2.0)

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Sie die Sprungliste für eine App entfernen, einschließlich aller benutzerdefinierten Elemente, die zuvor möglicherweise hinzugefügt wurden.

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

Im folgenden Beispiel wird veranschaulicht, wie der Typ der vom System verwalteten Gruppe festgelegt wird, die von der Sprungliste einer App verwendet wird, ohne dass sich dies auf vorhandene benutzerdefinierte Sprunglistenelemente auswirkt.

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

Hinweise

Die JumpList einer App wird mithilfe der LoadCurrentAsync-Methode abgerufen. Wenn eine Anwendung ihre Sprungliste nicht anpassen kann, stellt das System eine Standardsprungliste bereit. Derzeit werden in der Standardsprungliste zuletzt verwendete Elemente angezeigt. Stellen Sie sicher, dass Ihre App als Standarddateihandler für einen bestimmten Dateityp registriert wurde, den Sie in der Liste der zuletzt verwendeten Elemente anzeigen möchten. Weitere Informationen finden Sie unter Behandeln der Dateiaktivierung.

Eigenschaften

Items

Ruft die Liste der JumpListItems für die Sprungliste ab. Items ist vom Typ IVector(JumpListItem).
SystemGroupKind

Ruft den aktuellen Typ der vom System verwalteten Sprunglistengruppe ab oder legt diese fest.

Methoden

IsSupported()

Ruft einen Wert ab, der angibt, ob das System Sprunglisten unterstützt.

Hinweis

Nur die Desktopgerätefamilie unterstützt Sprunglisten. Änderungen, die an einer Sprungliste mit einer anderen Gerätefamilie vorgenommen werden, werden nicht beibehalten.
LoadCurrentAsync()

Ruft asynchron die aktuelle Sprungliste und die zugehörigen Elemente ab.
SaveAsync()

Speichert asynchron Änderungen an der Sprungliste und den zugehörigen Elementen.

Gilt für:

Weitere Informationen