SettingsCommand Class

Erstellt ein Objekt für Einstellungsbefehle, das eine Einstellungseingabe darstellt. Dieser Einstellungsbefehl kann dem ApplicationCommands Vektor angefügt werden.

Syntax


var settingsCommand = new Windows.UI.ApplicationSettings.SettingsCommand();

Attribute

[MarshalingBehavior(None)]
[Muse()]
[Version(0x06020000)]

Member

SettingsCommandKlasse hat diese Membertypen:

Konstruktoren

SettingsCommandKlasse hat diese Konstruktoren.

KonstruktorBeschreibung
SettingsCommand Creates a new settings command.

 

Methoden

The SettingsCommand Klasse erbt Methoden von Object Klasse (C#/VB/C++).

Eigenschaften

Der SettingsCommandKlasse hat diese Eigenschaften.

EigenschaftZugriffstypBeschreibung

AccountsCommand

SchreibgeschütztGets the command for a web account in the account settings pane.

Id

Lese-/SchreibzugriffGets or sets the command ID.

Invoked

Lese-/SchreibzugriffGets or sets the handler for the event that is raised when the user selects the command.

Label

Lese-/SchreibzugriffGets or sets the label for the command.

 

Hinweise

Hinweis  : Es handelt sich nicht um eine agile Klasse. Daher müssen Sie das Threadingmodell und das Marshallingverhalten berücksichtigen. Weitere Informationen finden Sie unter Threading und Marshalling (C++/CX) und Die Verwendung von Windows-Runtime-Objekten in einer Multithreaded-Umgebung (.NET).

Beispiele

Der folgende Code zeigt, wie App-Befehle mithilfe der SettingsPane und SettingsCommand-Klassen hinzugefügt werden. Das vollständige Beispiel finden Sie im App-Einstellungsbeispiel.


using Windows.UI.ApplicationSettings;
using Windows.UI.Popups;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
using Windows.UI.Xaml.Navigation;
using System;

// This is the click handler for the 'addSettingsScenarioAdd' button.  
// Replace this with your own handler if you have a button or buttons on this page.
void addSettingsScenarioAdd_Click(object sender, RoutedEventArgs e)
{
    Button b = sender as Button;
    if (b != null)
    {
        rootPage.NotifyUser(
            "You selected the " + b.Content + " button", 
            NotifyType.StatusMessage);

        if (!this.isEventRegistered)
        {
            SettingsPane.GetForCurrentView().CommandsRequested += onCommandsRequested;
            this.isEventRegistered = true;
        }
    }
}

void onSettingsCommand(IUICommand command)
{
    SettingsCommand settingsCommand = (SettingsCommand)command;
    rootPage.NotifyUser(
        "You selected the " + settingsCommand.Label + " settings command", 
        NotifyType.StatusMessage);
}

void onCommandsRequested(
    SettingsPane settingsPane, 
    SettingsPaneCommandsRequestedEventArgs eventArgs)
{
    UICommandInvokedHandler handler = new UICommandInvokedHandler(onSettingsCommand);

    SettingsCommand generalCommand = new SettingsCommand(
        "generalSettings", "General", handler);
    eventArgs.Request.ApplicationCommands.Add(generalCommand);

    SettingsCommand helpCommand = new SettingsCommand("helpPage", "Help", handler);
    eventArgs.Request.ApplicationCommands.Add(helpCommand);
}

Anforderungen

Mindestens unterstützter Client

Windows 8 [Nur Windows Store-Apps]

Mindestens unterstützter Server

Windows Server 2012 [Nur Windows Store-Apps]

Namespace

Windows.UI.ApplicationSettings
Windows::UI::ApplicationSettings [C++]

Metadaten

Windows.winmd

Siehe auch

SettingsPane
App-Einstellungsbeispiel

 

 

Anzeigen:
© 2014 Microsoft