CommandBarFlyout 클래스

정의

네임스페이스:

Microsoft.UI.Xaml.Controls

AppBarButton, AppBarToggleButton 및 AppBarSeparator 컨트롤에 대한 레이아웃을 제공하는 특수 플라이아웃을 나타냅니다.

/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.UI.Xaml.Markup.ContentProperty(Name="PrimaryCommands")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.XamlContract, 65536)]
class CommandBarFlyout : FlyoutBase

[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.UI.Xaml.Markup.ContentProperty(Name="PrimaryCommands")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.XamlContract), 65536)]
public class CommandBarFlyout : FlyoutBase

Public Class CommandBarFlyout
Inherits FlyoutBase

<CommandBarFlyout .../>
-or-
<CommandBarFlyout>
  commandBarElements
</CommandBarFlyout>

상속

Object IInspectable DependencyObject FlyoutBase CommandBarFlyout

파생

Microsoft.UI.Xaml.Controls.TextCommandBarFlyout

특성

MarshalingBehaviorAttribute ThreadingAttribute ContentPropertyAttribute ContractVersionAttribute

예제

팁

자세한 정보, 디자인 지침 및 코드 예제는 명령 모음 플라이아웃을 참조하세요.

WinUI 3 갤러리 앱을 열고 실행 중인 CommandBarFlyout을 확인합니다.

WinUI 3 갤러리 앱에는 대부분의 WinUI 3 컨트롤, 기능 및 기능에 대한 대화형 예제가 포함되어 있습니다. Microsoft Store에서 앱을 가져오거나 GitHub에서 소스 코드를 가져옵니다.

설명

AppBarElementContainer에 래핑하여 CommandBarFlyout에 다른 컨트롤을 추가할 수 있습니다. 여기에는 DropDownButton 또는 SplitButton과 같은 컨트롤 또는 더 복잡한 UI를 위한 StackPanel 과 같은 컨테이너가 포함됩니다.

컨트롤 스타일 및 템플릿

기본 Style 및 ControlTemplate 을 수정하여 컨트롤에 고유한 모양을 지정할 수 있습니다. 컨트롤의 스타일 및 템플릿을 수정하는 방법에 대한 자세한 내용은 XAML 스타일을 참조하세요. 컨트롤의 모양을 정의하는 기본 스타일, 템플릿 및 리소스가 파일에 포함 generic.xaml 됩니다. 디자인 목적으로 는 generic.xaml Windows 앱 SDK NuGet 패키지와 함께 설치됩니다. 기본적으로 이 위치는 \Users\<username>\.nuget\packages\microsoft.windowsappsdk\<version>\lib\uap10.0\Microsoft.UI\Themes\generic.xaml입니다. 다른 버전의 SDK의 스타일 및 리소스에는 다른 값이 있을 수 있습니다.

XAML에는 컨트롤 템플릿을 수정하지 않고 다른 시각적 상태에서 컨트롤의 색을 수정하는 데 사용할 수 있는 리소스도 포함되어 있습니다. 이러한 리소스를 수정하는 것은 Background 및 Foreground와 같은 속성을 설정하는 것이 좋습니다. 자세한 내용은 XAML 스타일 문서의 경량 스타일 섹션을 참조하세요.

생성자

CommandBarFlyout()

CommandBarFlyout 클래스의 새 instance 초기화합니다.

속성

AllowFocusOnInteraction	사용자가 상호 작용할 때 요소가 자동으로 포커스를 받는지 여부를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 FlyoutBase)
AllowFocusWhenDisabled	컨트롤이 비활성화될 때 포커스를 받을 수 있는지 여부를 지정하는 값을 가져오거나 설정합니다. (다음에서 상속됨 FlyoutBase)
AlwaysExpanded	CommandBarFlyout이 항상 확장됨 상태로 유지되어야 하는지 여부를 나타내는 값을 가져오거나 설정하며 사용자가 축소됨 상태로 들어가지 못하도록 차단합니다. 기본값은 false입니다.
AreOpenCloseAnimationsEnabled	플라이아웃을 열거나 닫을 때 애니메이션이 재생되는지 여부를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 FlyoutBase)
Dispatcher	항상 Windows 앱 SDK 앱에서 를 반환 null 합니다. 대신 DispatcherQueue 를 사용합니다. (다음에서 상속됨 DependencyObject)
DispatcherQueue	DispatcherQueue 이 개체가 연결된 을 가져옵니다. 는 DispatcherQueue 코드가 비 UI 스레드에 의해 시작되는 경우에도 UI 스레드에서 에 액세스할 DependencyObject 수 있는 기능을 나타냅니다. (다음에서 상속됨 DependencyObject)
ElementSoundMode	소리를 재생하는지 여부에 대한 컨트롤의 기본 설정을 지정하는 값을 가져오거나 설정합니다. (다음에서 상속됨 FlyoutBase)
InputDevicePrefersPrimaryCommands	플라이아웃을 여는 데 사용되는 입력 디바이스가 보조 명령을 쉽게 열지 않는지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 FlyoutBase)
IsConstrainedToRootBounds	플라이아웃이 XAML 루트의 범위 내에 표시되는지 여부를 나타내는 값을 가져옵니다. 이 속성은 Windows 앱 SDK 앱의 경우 항상 true입니다. (다음에서 상속됨 FlyoutBase)
IsOpen	플라이아웃이 열려 있는지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 FlyoutBase)
LightDismissOverlayMode	밝은 해제 UI 외부의 영역이 어둡게 표시되는지 여부를 지정하는 값을 가져오거나 설정합니다. (다음에서 상속됨 FlyoutBase)
OverlayInputPassThroughElement	플라이아웃 오버레이 아래에 있는 경우에도 포인터 입력 이벤트를 수신해야 하는 요소를 가져오거나 설정합니다. (다음에서 상속됨 FlyoutBase)
Placement	배치 대상과 관련하여 플라이아웃에 사용할 기본 배치를 가져오거나 설정합니다. (다음에서 상속됨 FlyoutBase)
PrimaryCommands	CommandBarFlyout에 대한 기본 명령 요소의 컬렉션을 가져옵니다.
SecondaryCommands	CommandBarFlyout에 대한 보조 명령 요소의 컬렉션을 가져옵니다.
ShouldConstrainToRootBounds	플라이아웃이 XAML 루트의 범위 내에 표시되어야 하는지 여부를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 FlyoutBase)
ShowMode	플라이아웃이 표시되면 동작하는 방식을 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 FlyoutBase)
SystemBackdrop	이 플라이아웃에 적용할 시스템 배경을 가져오거나 설정합니다. 배경은 플라이아웃 콘텐츠 뒤에 렌더링됩니다. (다음에서 상속됨 FlyoutBase)
Target	플라이아웃의 배치 대상으로 사용할 요소를 가져옵니다. (다음에서 상속됨 FlyoutBase)
XamlRoot	이 플라이아웃을 볼 XamlRoot를 가져오거나 설정합니다. (다음에서 상속됨 FlyoutBase)

메서드

ClearValue(DependencyProperty)	종속성 속성의 로컬 값을 지웁니다. (다음에서 상속됨 DependencyObject)
CreatePresenter()	파생 클래스에서 재정의되는 경우 플라이아웃 콘텐츠를 파생 컨트롤에 적절하게 표시하도록 컨트롤을 초기화합니다. 참고: 이 메서드는 기본 클래스 구현이 없으며 파생 클래스에서 재정의되어야 합니다. (다음에서 상속됨 FlyoutBase)
GetAnimationBaseValue(DependencyProperty)	애니메이션이 활성화되지 않은 경우 적용되는 종속성 속성에 대해 설정된 모든 기본 값을 반환합니다. (다음에서 상속됨 DependencyObject)
GetValue(DependencyProperty)	DependencyObject에서 종속성 속성의 현재 유효 값을 반환합니다. (다음에서 상속됨 DependencyObject)
Hide()	플라이아웃을 닫습니다. (다음에서 상속됨 FlyoutBase)
OnProcessKeyboardAccelerators(ProcessKeyboardAcceleratorEventArgs)	바로 가기 키(가속기)가 앱에서 처리되기 직전에 호출됩니다. 애플리케이션 코드 또는 내부 프로세스에서 ProcessKeyboardAccelerators를 호출할 때마다 호출됩니다. 기본 가속기 처리에 영향을 주도록 이 메서드를 재정의합니다. (다음에서 상속됨 FlyoutBase)
ReadLocalValue(DependencyProperty)	로컬 값이 설정된 경우 종속성 속성의 로컬 값을 반환합니다. (다음에서 상속됨 DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	이 DependencyObject instance 특정 DependencyProperty의 변경 내용을 수신 대기하기 위한 알림 함수를 등록합니다. (다음에서 상속됨 DependencyObject)
SetValue(DependencyProperty, Object)	DependencyObject에서 종속성 속성의 로컬 값을 설정합니다. (다음에서 상속됨 DependencyObject)
ShowAt(DependencyObject, FlyoutShowOptions)	지정된 옵션을 사용하여 지정된 요소와 관련하여 배치된 플라이아웃을 표시합니다. (다음에서 상속됨 FlyoutBase)
ShowAt(FrameworkElement)	지정된 요소와 관련하여 배치된 플라이아웃을 표시합니다. (다음에서 상속됨 FlyoutBase)
TryInvokeKeyboardAccelerator(ProcessKeyboardAcceleratorEventArgs)	바로 가기 키(액셀러레이터)를 호출하려고 시도합니다. (다음에서 상속됨 FlyoutBase)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	RegisterPropertyChangedCallback을 호출하여 이전에 등록된 변경 알림을 취소합니다. (다음에서 상속됨 DependencyObject)

이벤트

Closed	플라이아웃이 숨겨져 있을 때 발생합니다. (다음에서 상속됨 FlyoutBase)
Closing	플라이아웃이 숨겨지기 시작할 때 발생합니다. (다음에서 상속됨 FlyoutBase)
Opened	플라이아웃이 표시되면 발생합니다. (다음에서 상속됨 FlyoutBase)
Opening	플라이아웃이 표시되기 전에 발생합니다. (다음에서 상속됨 FlyoutBase)

추가 정보

• 명령 모음 플라이아웃