SettingsPane, classe

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


Imports Windows.UI.ApplicationSettings
Imports Windows.UI.Popups
Imports Windows.UI.Xaml
Imports Windows.UI.Xaml.Controls
Imports Windows.UI.Xaml.Navigation
Imports 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.
    Private Sub addSettingsScenarioAdd_Click(sender As Object, e As RoutedEventArgs)
        Dim b As Button = TryCast(sender, Button)
        If b IsNot Nothing Then
            rootPage.NotifyUser("You selected the " & b.Content & " button", _
                NotifyType.StatusMessage)
            If Not Me.isEventRegistered Then
                AddHandler SettingsPane.GetForCurrentView.CommandsRequested, _
                    AddressOf onCommandsRequested
                Me.isEventRegistered = True
            End If
        End If
    End Sub

    Private Sub onSettingsCommand(command As IUICommand)
        Dim settingsCommand As SettingsCommand = DirectCast(command, SettingsCommand)
        rootPage.NotifyUser( _
        "You selected the " & settingsCommand.Label & " command from the " & SettingsPane.Edge.ToString(), _
        NotifyType.StatusMessage)
    End Sub

    Private Sub onCommandsRequested(settingsPane As SettingsPane, _
        eventArgs As SettingsPaneCommandsRequestedEventArgs)
        Dim handler As New UICommandInvokedHandler(AddressOf onSettingsCommand)

        Dim generalCommand As New SettingsCommand("generalSettings", "General", handler)
        eventArgs.Request.ApplicationCommands.Add(generalCommand)

        Dim helpCommand As New SettingsCommand("helpPage", "Help", handler)
        eventArgs.Request.ApplicationCommands.Add(helpCommand)
    End Sub


    '' This is the click handler for the 'addSettingsScenarioShow' button.  
    '' Replace this with your own handler if you have a button or buttons on this page.
    Private Sub addSettingsScenarioShow_Click(sender As Object, e As RoutedEventArgs)
        Dim b As Button = TryCast(sender, Button)
        If b IsNot Nothing Then
            rootPage.NotifyUser("You selected the " & b.Content & " button", _
                NotifyType.StatusMessage)
            SettingsPane.Show()
        End If
    End Sub


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:
© 2018 Microsoft