CommandBarFlyout 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
AppBarButton 및 관련 명령 요소에 대한 레이아웃을 제공하는 특수 플라이아웃을 나타냅니다.
UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Controls.CommandBarFlyout(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 458752)]
/// [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")]
class CommandBarFlyout : FlyoutBase[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 458752)]
[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")]
public class CommandBarFlyout : FlyoutBasePublic Class CommandBarFlyout
Inherits FlyoutBase<CommandBarFlyout .../>
-or-
<CommandBarFlyout>
commandBarElements
</CommandBarFlyout>
- 상속
- 파생
- 특성
Windows 요구 사항
| 디바이스 패밀리 |
Windows 10, version 1809 (10.0.17763.0에서 도입되었습니다.)
|
| API contract |
Windows.Foundation.UniversalApiContract (v7.0에서 도입되었습니다.)
|
예제
팁
자세한 정보, 디자인 지침 및 코드 예제는 명령 모음 플라이아웃을 참조하세요.
WinUI 2 갤러리 앱이 설치된 경우 여기를 클릭하여 앱을 열고 작동 중인 CommandBarFlyout을 확인합니다.
설명
컨트롤 스타일 및 템플릿
기본 스타일 및 ControlTemplate 을 수정하여 컨트롤에 고유한 모양을 지정할 수 있습니다. 컨트롤의 스타일 및 템플릿을 수정하는 방법에 대한 자세한 내용은 컨트롤 스타일 지정을 참조하세요. 컨트롤의 모양을 정의하는 기본 스타일, 템플릿 및 리소스가 파일에 포함 generic.xaml 됩니다. 디자인 목적으로 는 generic.xaml SDK 또는 NuGet 패키지 설치와 함께 로컬로 사용할 수 있습니다.
- *WinUI 스타일(권장):Microsoft.UI.Xaml.Controls.CommandBarFlyout을 사용합니다.
- 비 WinUI 스타일: 기본 제공 스타일은 을 참조하세요
%ProgramFiles(x86)%\Windows Kits\10\DesignTime\CommonConfiguration\Neutral\UAP\<SDK version>\Generic\generic.xaml.
설치를 사용자 지정한 경우 위치가 다를 수 있습니다. 다른 버전의 SDK의 스타일 및 리소스에는 다른 값이 있을 수 있습니다.
XAML에는 컨트롤 템플릿을 수정하지 않고 다른 시각적 상태에서 컨트롤의 색을 수정하는 데 사용할 수 있는 리소스도 포함되어 있습니다. 이러한 리소스를 수정하는 것은 Background 및 Foreground와 같은 속성을 설정하는 것이 좋습니다. 자세한 내용은 XAML 스타일 문서의 경량 스타일 섹션을 참조하세요. 경량 스타일 리소스는 Windows 10 버전 1607(SDK 14393)부터 사용할 수 있습니다.
생성자
| CommandBarFlyout() |
CommandBarFlyout 클래스의 새 instance 초기화합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Controls.CommandBarFlyout.-ctor(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). |
속성
| AllowFocusOnInteraction |
사용자가 상호 작용할 때 요소가 자동으로 포커스를 가져오는지 여부를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 FlyoutBase) |
| AllowFocusWhenDisabled |
컨트롤이 비활성화될 때 포커스를 받을 수 있는지 여부를 지정하는 값을 가져오거나 설정합니다. (다음에서 상속됨 FlyoutBase) |
| AreOpenCloseAnimationsEnabled |
플라이아웃을 열거나 닫을 때 애니메이션이 재생되는지 여부를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 FlyoutBase) |
| Dispatcher |
이 개체가 연결된 CoreDispatcher 를 가져옵니다. CoreDispatcher는 코드가 비 UI 스레드에서 시작되더라도 UI 스레드에서 DependencyObject에 액세스할 수 있는 기능을 나타냅니다. (다음에서 상속됨 DependencyObject) |
| ElementSoundMode |
소리를 재생하는지 여부에 대한 컨트롤의 기본 설정을 지정하는 값을 가져오거나 설정합니다. (다음에서 상속됨 FlyoutBase) |
| InputDevicePrefersPrimaryCommands |
플라이아웃을 여는 데 사용되는 입력 디바이스가 보조 명령을 쉽게 열지 않는지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 FlyoutBase) |
| IsConstrainedToRootBounds |
플라이아웃이 XAML 루트의 범위 내에 표시되는지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 FlyoutBase) |
| IsOpen |
플라이아웃이 열려 있는지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 FlyoutBase) |
| LightDismissOverlayMode |
광원 해제 UI 외부 영역이 어둡게 표시되는지 여부를 지정하는 값을 가져오거나 설정합니다. (다음에서 상속됨 FlyoutBase) |
| OverlayInputPassThroughElement |
플라이아웃 오버레이 아래에 있는 경우에도 포인터 입력 이벤트를 수신해야 하는 요소를 가져오거나 설정합니다. (다음에서 상속됨 FlyoutBase) |
| Placement |
배치 대상과 관련하여 플라이아웃에 사용할 기본 배치를 가져오거나 설정합니다. (다음에서 상속됨 FlyoutBase) |
| PrimaryCommands |
CommandBarFlyout에 대한 기본 명령 요소의 컬렉션을 가져옵니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Controls.CommandBarFlyout.PrimaryCommands(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). |
| SecondaryCommands |
CommandBarFlyout에 대한 보조 명령 요소의 컬렉션을 가져옵니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Controls.CommandBarFlyout.SecondaryCommands(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). |
| ShouldConstrainToRootBounds |
플라이아웃이 XAML 루트의 범위 내에 표시되어야 하는지 여부를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 FlyoutBase) |
| ShowMode |
플라이아웃이 표시되면 동작하는 방식을 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 FlyoutBase) |
| Target |
플라이아웃의 배치 대상으로 사용할 요소를 가져옵니다. (다음에서 상속됨 FlyoutBase) |
| XamlRoot |
이 플라이아웃을 볼 XamlRoot를 가져오거나 설정합니다. (다음에서 상속됨 FlyoutBase) |
메서드
이벤트
| Closed |
플라이아웃이 숨겨져 있을 때 발생합니다. (다음에서 상속됨 FlyoutBase) |
| Closing |
플라이아웃이 숨겨지기 시작할 때 발생합니다. (다음에서 상속됨 FlyoutBase) |
| Opened |
플라이아웃이 표시되면 발생합니다. (다음에서 상속됨 FlyoutBase) |
| Opening |
플라이아웃이 표시되기 전에 발생합니다. (다음에서 상속됨 FlyoutBase) |
적용 대상
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기