SettingsPane Class

Una clase estática que permite a la aplicación controlar el panel de acceso a Configuración. La aplicación puede agregar o quitar comandos, recibir una notificación cuando el usuario abrir el panel o abrir el panel mediante programación.

Sintaxis


var settingsPane = Windows.UI.ApplicationSettings.SettingsPane.getForCurrentView();

Atributos

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

Members

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

Eventos

A continuación se indican los eventos de SettingsPane (Clase).

EventoDescripción
CommandsRequested Occurs when the user opens the settings pane. Listening for this event lets the app initialize the setting commands and pause its UI until the user closes the pane.

 

Métodos

The SettingsPane Clase tiene estos métodos. Con C#, Visual Basic y C++, también hereda métodos de Object Clase.

MétodoDescripción
GetForCurrentView Gets a SettingsPane object that is associated with the current app view (that is, with CoreWindow).
Show Displays the Settings Charm pane to the user.

 

Propiedades

SettingsPaneClase tiene estas propiedades.

PropiedadTipo de accesoDescripción

Edge

De sólo lecturaGets a value indicating whether the Settings charm appears on the left or right edge of the screen.

 

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 from the " + 
        SettingsPane.Edge.ToString(), 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

SettingsCommand
Ejemplo de configuración de la aplicación

 

 

Mostrar:
© 2014 Microsoft