SettingsPane Class

Une classe statique qui permet à l'application de contrôler le volet des symboles des paramètres. L'application peut ajouter ou supprimer des commandes, recevoir une notification lorsque l'utilisateur ouvre le volet, ou ouvrir le volet par programmation.

Syntaxe


public sealed class SettingsPane

Attributs

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

Membres

SettingsPaneClasse possède ces types de membres :

Événements

SettingsPaneClasse possède ces événements.

ÉvénementDescription
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éthodes

The SettingsPane Classe a les méthodes suivantes. Avec C#, Visual Basic et C++, elle hérite également des méthodes de Object Classe.

MéthodeDescription
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.

 

Propriétés

Le SettingsPaneClasse a les propriétés suivantes.

PropriétéType d'accèsDescription

Edge

En lecture seuleGets a value indicating whether the Settings charm appears on the left or right edge of the screen.

 

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

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

SettingsCommand
Exemple de paramètres d'application

 

 

Afficher:
© 2014 Microsoft