AdaptiveTrigger 클래스

정의

네임스페이스:

Windows.UI.Xaml

창 속성에 따라 시각적 상태를 적용하는 선언적 규칙을 나타냅니다.

UWP용 동등한 WinUI 2 API: Microsoft.UI.Xaml.AdaptiveTrigger(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class AdaptiveTrigger : StateTriggerBase

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class AdaptiveTrigger : StateTriggerBase

Public Class AdaptiveTrigger
Inherits StateTriggerBase

<AdaptiveTrigger .../>

상속

Object IInspectable DependencyObject StateTriggerBase AdaptiveTrigger

특성

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 요구 사항

디바이스 패밀리	Windows 10 (10.0.10240.0에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)

예제

팁

자세한 정보, 디자인 지침 및 코드 예제는 XAML을 사용한 반응형 레이아웃을 참조하세요.

WinUI 2 갤러리 앱 이 설치된 경우 앱을 열어 실행 중인 컨트롤을 확인합니다.

• WinUI 2 갤러리 앱 받기(Microsoft Store)
• 소스 코드 가져오기(GitHub)

이 예제에서는 AdaptiveTrigger와 함께 속성을 사용하여 StateTriggers 창 크기에 따라 XAML 태그에 선언적 규칙을 만드는 방법을 보여 줍니다. 기본적으로 방향은 세 로 StackPanel 입니다. 창 너비가 >= 720 유효 VisualState 픽셀이면 변경 내용이 트리거되고 StackPanel 방향이 가로 로 변경됩니다.

<Page>
    <Grid Background="{ThemeResource ApplicationPageBackgroundThemeBrush}">
        <VisualStateManager.VisualStateGroups>
            <VisualStateGroup>
                <VisualState>
                    <VisualState.StateTriggers>
                    <!--VisualState to be triggered when window width is >=720 effective pixels.-->
                        <AdaptiveTrigger MinWindowWidth="720"/>
                    </VisualState.StateTriggers>

                    <VisualState.Setters>
                        <Setter Target="myPanel.Orientation" Value="Horizontal"/>
                    </VisualState.Setters>
                </VisualState>
            </VisualStateGroup>
        </VisualStateManager.VisualStateGroups>
        <StackPanel x:Name="myPanel" Orientation="Vertical">
            <TextBlock Text="This is a block of text. It is text block 1. " 
                       Style="{ThemeResource BodyTextBlockStyle}"/>
            <TextBlock Text="This is a block of text. It is text block 2. " 
                       Style="{ThemeResource BodyTextBlockStyle}"/>
            <TextBlock Text="This is a block of text. It is text block 3. " 
                       Style="{ThemeResource BodyTextBlockStyle}"/>
        </StackPanel>
    </Grid>
</Page>

자세한 샘플은 상태 트리거 샘플을 참조하세요.

설명

AdaptiveTriggers를 사용하여 창이 지정된 높이 또는 너비일 VisualState 때 변경 사항을 자동으로 트리거하는 규칙을 만듭니다. XAML 태그에서 AdaptiveTriggers를 사용하는 경우 코드에서 이벤트 및 호출 VisualStateManager.GoToState 을 Window.SizeChanged 처리할 필요가 없습니다. 또한 AdaptiveTriggers를 VisualStateManager사용하는 경우 이러한 적응형 변경 내용이 Microsoft Visual Studio XAML 디자인 화면에 직접 미치는 영향을 확인할 수 있습니다.

독립적으로 또는 서로 함께 및 MinWindowHeight 속성을 사용할 MinWindowWidth 수 있습니다. 이 XAML은 두 속성을 함께 사용하는 예제를 보여 줍니다. 트리거는 현재 창 너비가 = 720 유효 픽셀이고 >현재 창 높이가 = 900 유효 픽셀일 때 해당 VisualState 값이 >적용됨을 나타냅니다.

<AdaptiveTrigger MinWindowWidth="720" MinWindowHeight="900"/>

생성자

AdaptiveTrigger()

AdaptiveTrigger 클래스의 새 인스턴스를 초기화합니다.

속성

Dispatcher	이 개체가 CoreDispatcher 연결된 개체를 가져옵니다. 코드 CoreDispatcher 가 비 UI 스레드에서 시작되는 경우에도 UI 스레드에 액세스할 DependencyObject 수 있는 기능을 나타냅니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.DependencyObject.Dispatcher(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). (다음에서 상속됨 DependencyObject)
MinWindowHeight	적용해야 하는 최소 창 높이를 VisualState 가져오거나 설정합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.AdaptiveTrigger.MinWindowHeight(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
MinWindowHeightProperty	MinWindowHeight 종속성 속성을 나타냅니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.AdaptiveTrigger.MinWindowHeightProperty(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
MinWindowWidth	적용해야 하는 최소 창 너비를 VisualState 가져오거나 설정합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.AdaptiveTrigger.MinWindowWidth(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
MinWindowWidthProperty	MinWindowWidth 종속성 속성을 나타냅니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.AdaptiveTrigger.MinWindowWidthProperty(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

메서드

ClearValue(DependencyProperty)	종속성 속성의 로컬 값을 지웁니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.DependencyObject.ClearValue(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). (다음에서 상속됨 DependencyObject)
GetAnimationBaseValue(DependencyProperty)	애니메이션이 활성화되지 않은 경우에 적용되는 종속성 속성에 대해 설정된 기본 값을 반환합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.DependencyObject.GetAnimationBaseValue(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). (다음에서 상속됨 DependencyObject)
GetValue(DependencyProperty)	에서 종속성 속성 DependencyObject의 현재 유효 값을 반환합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.DependencyObject.GetValue(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). (다음에서 상속됨 DependencyObject)
ReadLocalValue(DependencyProperty)	로컬 값이 설정된 경우 종속성 속성의 로컬 값을 반환합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.DependencyObject.ReadLocalValue(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). (다음에서 상속됨 DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	이 DependencyObject 인스턴스의 특정 DependencyProperty 변경 내용을 수신 대기하기 위한 알림 함수를 등록합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.DependencyObject.RegisterPropertyChangedCallback(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). (다음에서 상속됨 DependencyObject)
SetActive(Boolean)	상태 트리거가 활성 상태인지 여부를 나타내는 값을 설정합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.StateTriggerBase.SetActive(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). (다음에서 상속됨 StateTriggerBase)
SetValue(DependencyProperty, Object)	에 종속성 속성 DependencyObject의 로컬 값을 설정합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.DependencyObject.SetValue(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). (다음에서 상속됨 DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	를 호출 RegisterPropertyChangedCallback하여 이전에 등록한 변경 알림을 취소합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.DependencyObject.UnregisterPropertyChangedCallback(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). (다음에서 상속됨 DependencyObject)

추가 정보

• VisualState
• StateTriggerBase
• StateTriggers
• XAML을 사용한 반응형 레이아웃