Windows Dev Center

SettingsCommand Class

Crée un objet de commande de paramètres qui représente une entrée de paramètres. Cette commande de paramètres peut être ajoutée au vecteur ApplicationCommands.

Syntaxe


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

Attributs

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

Membres

SettingsCommandClasse possède ces types de membres :

Constructeurs

SettingsCommandClasse possède ces constructeurs.

ConstructeurDescription
SettingsCommand Creates a new settings command.

 

Méthodes

The SettingsCommand Classe hérite des méthodes de Object Classe (C#/VB/C++).

Propriétés

Le SettingsCommandClasse a les propriétés suivantes.

PropriétéType d'accèsDescription

AccountsCommand

En lecture seuleGets the command for a web account in the account settings pane.

Id

Lecture/écritureGets or sets the command ID.

Invoked

Lecture/écritureGets or sets the handler for the event that is raised when the user selects the command.

Label

Lecture/écritureGets or sets the label for the command.

 

Remarques

Remarque   : cette classe n'est pas agile, ce qui signifie que vous devez prendre en compte son modèle de thread et son comportement de marshaling. Pour plus d'informations, consultez Threads et marshaling (C++/CX) et Utilisation d'objets Windows Runtime dans un environnement multithread (.NET).

Exemples

Le code suivant indique comment ajouter des commandes d'application à l'aide des classes SettingsPane et SettingsCommand. Pour obtenir l'exemple complet, consultez App settings sample.


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

Conditions requises

Client minimal pris en charge

Windows 8 [Applications Windows Store uniquement]

Serveur minimal pris en charge

Windows Server 2012 [Applications Windows Store uniquement]

Espace de noms

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

Métadonnées

Windows.winmd

Voir aussi

SettingsPane
Exemple de paramètres d'application

 

 

Afficher:
© 2015 Microsoft