AdaptiveTrigger 类

定义

命名空间:

Windows.UI.Xaml

表示基于窗口属性应用视觉状态的声明性规则。

/// [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)

此示例演示如何将 StateTriggers 属性与 AdaptiveTrigger 配合使用，以基于窗口大小在 XAML 标记中创建声明性规则。 默认情况下， StackPanel 方向为 “垂直”。 当窗口宽度 >= 720 有效像素时，将触发 VisualState 更改， 并将 StackPanel 方向更改为 Horizontal。

<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 时，无需处理 Window.SizeChanged 事件并在代码中调用 VisualStateManager.GoToState 。 此外，在 VisualStateManager 中使用 AdaptiveTriggers 时，可以直接在 Microsoft Visual Studio 的 XAML 设计图面上查看这些自适应更改的效果。

可以独立或结合使用 MinWindowWidth 和 MinWindowHeight 属性。 此 XAML 演示了同时使用这两个属性的示例。 触发器指示当当前窗口宽度 >= 720 有效像素且当前窗口高度>为 = 900 有效像素时，将应用相应的 VisualState。

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

构造函数

AdaptiveTrigger()

初始化 AdaptiveTrigger 类的新实例

属性

Dispatcher	获取与此对象关联的 CoreDispatcher 。 CoreDispatcher 表示可以访问 UI 线程上的 DependencyObject 的工具，即使代码是由非 UI 线程启动的。 (继承自 DependencyObject)
MinWindowHeight	获取或设置应应用 VisualState 的最小窗口高度。
MinWindowHeightProperty	标识 MinWindowHeight 依赖属性。
MinWindowWidth	获取或设置应应用 VisualState 的最小窗口宽度。
MinWindowWidthProperty	标识 MinWindowWidth 依赖属性。

方法

ClearValue(DependencyProperty)	清除依赖属性的本地值。 (继承自 DependencyObject)
GetAnimationBaseValue(DependencyProperty)	返回为依赖属性建立的任何基值，该基值适用于动画未处于活动状态的情况。 (继承自 DependencyObject)
GetValue(DependencyProperty)	从 DependencyObject 返回依赖属性的当前有效值。 (继承自 DependencyObject)
ReadLocalValue(DependencyProperty)	如果设置了本地值，则返回依赖属性的本地值。 (继承自 DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	注册通知函数，用于侦听此 DependencyObject 实例上对特定 DependencyProperty 的更改。 (继承自 DependencyObject)
SetActive(Boolean)	设置指示状态触发器是否处于活动状态的值。 (继承自 StateTriggerBase)
SetValue(DependencyProperty, Object)	设置 DependencyObject 上依赖属性的本地值。 (继承自 DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	取消以前通过调用 RegisterPropertyChangedCallback 注册的更改通知。 (继承自 DependencyObject)

另请参阅

• VisualState
• StateTriggerBase
• StateTriggers
• 采用 XAML 的响应式布局