SettingsCommand Class

Crea un objeto de comando de configuración que representa una entrada de configuración. Este comando de configuración se puede anexar al vector ApplicationCommands.

Sintaxis


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

Atributos

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

Members

A continuación se indican los tipos de miembros de SettingsCommand (Clase):

Constructores

A continuación se indican los constructores de SettingsCommand (Clase).

ConstructorDescripción
SettingsCommand Creates a new settings command.

 

Métodos

The SettingsCommand Clase hereda métodos de Object Clase (C#/VB/C++).

Propiedades

SettingsCommandClase tiene estas propiedades.

PropiedadTipo de accesoDescripción

AccountsCommand

De sólo lecturaGets the command for a web account in the account settings pane.

Id

Lectura/escrituraGets or sets the command ID.

Invoked

Lectura/escrituraGets or sets the handler for the event that is raised when the user selects the command.

Label

Lectura/escrituraGets or sets the label for the command.

 

Comentarios

Nota  : esta clase no es ágil, lo que significa que debe tener en cuenta su modelo de subprocesos y el comportamiento del cálculo de referencias. Para obtener más información, vea Subprocesos y cálculo de referencias (C++/CX) y Usar objetos de Windows en tiempo de ejecución en un entorno multiproceso (.NET).

Ejemplos

El código siguiente muestra cómo agregar comandos de la aplicación mediante las clases SettingsPane y SettingsCommand. Para obtener el ejemplo completo, vea Ejemplo de configuración de la aplicación.


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

Requisitos

Cliente mínimo admitido

Windows 8 [Solo aplicaciones de la Tienda Windows]

Servidor mínimo admitido

Windows Server 2012 [Solo aplicaciones de la Tienda Windows]

Espacio de nombres

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

Metadatos

Windows.winmd

Vea también

SettingsPane
Ejemplo de configuración de la aplicación

 

 

Mostrar:
© 2014 Microsoft