SettingsPane Class

Eine statische Klasse, mit der die Anwendung den Bereich für den Charm "Einstellungen" steuern kann. Die App kann Befehle hinzufügen oder entfernen, eine Benachrichtigung empfangen, wenn der Benutzer den Bereich öffnet, oder den Bereich programmgesteuert öffnen.

Syntax


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

Attribute

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

Member

SettingsPaneKlasse hat diese Membertypen:

Ereignisse

SettingsPaneKlasse hat diese Ereignisse.

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

 

Methoden

The SettingsPane Klasse hat diese Methoden. Mit C#, Visual Basic und C++ erbt es auch Methoden aus Object Klasse.

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

 

Eigenschaften

Der SettingsPaneKlasse hat diese Eigenschaften.

EigenschaftZugriffstypBeschreibung

Edge

SchreibgeschütztGets a value indicating whether the Settings charm appears on the left or right edge of the screen.

 

Hinweise

Hinweis  : Es handelt sich nicht um eine agile Klasse. Daher müssen Sie das Threadingmodell und das Marshallingverhalten berücksichtigen. Weitere Informationen finden Sie unter Threading und Marshalling (C++/CX) und Die Verwendung von Windows-Runtime-Objekten in einer Multithreaded-Umgebung (.NET).

Beispiele

Der folgende Code zeigt, wie App-Befehle mithilfe der SettingsPane und SettingsCommand-Klassen hinzugefügt werden. Das vollständige Beispiel finden Sie im App-Einstellungsbeispiel.


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

Anforderungen

Mindestens unterstützter Client

Windows 8 [Nur Windows Store-Apps]

Mindestens unterstützter Server

Windows Server 2012 [Nur Windows Store-Apps]

Namespace

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

Metadaten

Windows.winmd

Siehe auch

SettingsCommand
App-Einstellungsbeispiel

 

 

Anzeigen:
© 2014 Microsoft