Schnellstart: Hinzufügen von App-Einstellungen mit der Windows-Runtime

  • Artikel

[ Dieser Artikel richtet sich an Windows 8.x- und Windows Phone 8.x-Entwickler, die Windows-Runtime-Apps schreiben. Wenn Sie für Windows 10 entwickeln, finden Sie weitere Informationen unter neueste Dokumentation]

Diese Schnellstartanleitung führt Sie durch die Implementierung des Vertrags für "Einstellungen" mit Windows-Runtime-Klassen. Wir empfehlen Ihnen aber, sich stattdessen an die Schritte unter Schnellstart: Hinzufügen von App-Einstellungen mit der Windows-Bibliothek für JavaScript zu halten. Wenn Sie eine App mit C++/C#/VB und XAML erstellen, finden Sie stattdessen Informationen unter Schnellstart: Hinzufügen von App-Einstellungen.

Voraussetzungen

Lesen Sie die Richtlinien für App-Einstellungen.

1. Angeben der Befehle, die in den Einstellungen verfügbar gemacht werden sollen

  1. Überwachen Sie das CommandsRequested-Ereignis des Einstellungsbereichs.

  2. Geben Sie die Befehle im zugehörigen Rückruf an. Führen Sie Folgendes für jeden Befehl aus:

    1. Stellen Sie eine Datei SettingsCommand.Id und ein lokalisiertes SettingsCommand.Label bereit.
    2. Legen Sie den Ereignishandler (SettingsCommand.Invoked) für das Ereignis fest, das bei der Auswahl des Befehls durch den Benutzer ausgelöst wird.
    3. Fügen Sie das SettingsCommand-Objekt an den ApplicationCommands-Vektor an, damit er im SettingsPane verfügbar ist.

2. Anzeigen der jeweiligen benutzerdefinierten Einstellungen bei einer Benutzeranforderung

  • Zeigen Sie die entsprechende Einstellungs-UI für die App an, wenn ein Benutzer einen Einstellungsbefehl aufruft.
  • Halten Sie die UI hierfür einfach. Sie sollte schnell zu beenden sein, damit der Benutzer im aktuellen App-Kontext bleibt.
  • Änderungen an Einstellungen sollten sich sofort in der App widerspiegeln.
  • Zeigen Sie die Einstellungs-Benutzeroberfläche auf der gleichen Seite an, auf der die Charms angezeigt werden, indem Sie die "SettingsEdgeLocation"-Eigenschaft überprüfen.

Zusammenfassung

Sie haben in dieser Schnellstartanleitung die beiden wichtigsten Schritte beim Einrichten des Vertrags für "Einstellungen" mit Windows-Runtime-Klassen kennengelernt.

Verwandte Themen

Beispiele

Beispiel für App-Einstellungen

Nachschlagewerk

Windows.UI.ApplicationSettings

Dokumentation

Schnellstart: Verwenden der Windows-Bibliothek für JavaScript

Richtlinien für App-Einstellungen