SettingsPane 클래스

SettingsPane Class

응용 프로그램에서 설정 참 창을 제어할 수 있도록 설정하는 정적 클래스입니다. 응용 프로그램에서 명령을 추가하거나 제거할 수 있으며, 사용자가 창을 열 때 알림을 받거나 창을 프로그래밍 방식으로 열 수 있습니다.

구문


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

특성

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

멤버

SettingsPane클래스에는 다음과 같은 형식의 멤버가 있습니다.

이벤트

SettingsPane클래스에는 다음과 같은 이벤트가 있습니다.

이벤트Description
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.

 

메서드

The SettingsPane 클래스 - 이러한 메서드가 있습니다. C#, Visual Basic 및 C++에서는 다음 위치의 메서드도 상속합니다. Object 클래스.

메서드Description
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.

 

속성

SettingsPane클래스 - 이러한 속성이 있습니다.

속성사용 권한Description

Edge

읽기 전용Gets a value indicating whether the Settings charm appears on the left or right edge of the screen.

 

설명

참고  : 이 클래스는 Agile 클래스가 아닙니다. 즉, 이 클래스의 스레딩 모델 및 마샬링 동작을 고려해야 합니다. 자세한 내용은 스레딩 및 마샬링(C++/CX)다중 스레드 환경에서 Windows 런타임 개체 사용(.NET)을 참조하십시오.

예제

다음 코드는 SettingsPaneSettingsCommand 클래스를 사용하여 앱 명령을 추가하는 방법을 보여 줍니다. 전체 예제는 앱 설정 샘플을 참조하십시오.


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

요구 사항

지원되는 최소 클라이언트

Windows 8 [Windows 스토어 앱만]

지원되는 최소 서버

Windows Server 2012 [Windows 스토어 앱만]

Namespace

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

Metadata

Windows.winmd

참고 항목

SettingsCommand
앱 설정 샘플

 

 

표시:
© 2016 Microsoft