SettingsPane Class

Una classe statica che consente all'applicazione di controllare il riquadro del pulsante di accesso rapido Impostazioni. L'applicazione è in grado di aggiungere o rimuovere comandi, ricevere una notifica quando l'utente apre il riquadro o aprire il riquadro a livello di programmazione.

Sintassi


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

Attributi

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

Membri

SettingsPaneClasse include questi tipi di membri:

Eventi

SettingsPaneClasse include questi eventi.

EventoDescrizione
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.

 

Metodi

The SettingsPane Classe dispone di tali metodi. In C#, Visual Basic e C++, eredita inoltre i metodi da Object Classe.

MetodoDescrizione
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.

 

Proprietà

Classe dispone di tali proprietà. di SettingsPane

ProprietàTipo di accessoDescrizione

Edge

Sola letturaGets a value indicating whether the Settings charm appears on the left or right edge of the screen.

 

Note

Nota  : Questa classe non è Agile, cioè è necessario considerare il relativo modello di threading e il relativo comportamento di marshalling. Per ulteriori informazioni, vedere la sezione Threading e marshaling (C++/CX) e Utilizzo di oggetti Windows Runtime in un ambiente con multithreading (.NET).

Esempi

Il codice seguente mostra come aggiungere comandi di un'applicazione utilizzando le classi SettingsPane e SettingsCommand. Per l'esempio completo, vedere Esempio di impostazioni dell'applicazione.


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

Requisiti

Client supportato minimo

Windows 8 [Solo applicazioni Windows Store]

Server supportato minimo

Windows Server 2012 [Solo applicazioni Windows Store]

Spazio dei nomi

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

Metadati

Windows.winmd

Vedere anche

SettingsCommand
Esempio di impostazioni dell'app

 

 

Mostra:
© 2014 Microsoft