AdaptiveTrigger Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt eine deklarative Regel dar, die visuelle Zustände basierend auf Fenstereigenschaften anwendet.
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 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(Microsoft.UI.Xaml.WinUIContract), 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
- Vererbung
- Attribute
Beispiele
Tip
Weitere Informationen, Entwurfsanleitungen und Codebeispiele finden Sie unter Dynamische Layouts mit XAML.
Das folgende Beispiel zeigt, wie Sie die StateTriggers-Eigenschaft mit einer AdaptiveTrigger eigenschaft verwenden, um eine deklarative Regel im XAML-Markup basierend auf der Fenstergröße zu erstellen. Standardmäßig ist Verticaldie StackPanel-Ausrichtung . Wenn die Fensterbreite = 720 effektive Pixel ist >, wird die VisualState-Änderung ausgelöst, und die StackPanel Ausrichtung wird geändert in 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>
Hinweise
Verwenden Sie AdaptiveTriggers, um Regeln zu erstellen, die automatisch eine VisualState-Änderung auslösen, wenn das Fenster eine angegebene Höhe oder Breite aufweist. Wenn Sie adaptiveTrigger in Ihrem XAML-Markup verwenden, müssen Sie das Window.SizeChanged-Ereignis nicht behandeln und VisualStateManager.GoToState in Ihrem Code aufrufen. Wenn Sie adaptiveTrigger in VisualStateManager verwenden, können Sie auch die Auswirkungen dieser adaptiven Änderungen direkt auf der XAML-Entwurfsoberfläche in Microsoft Visual Studio sehen.
Sie können die MinWindowWidth - und MinWindowHeight-Eigenschaften entweder unabhängig oder in Verbindung miteinander verwenden. Dieser XAML-Code zeigt ein Beispiel für die gemeinsame Verwendung beider Eigenschaften. Der Trigger gibt an, dass der entsprechende VisualState angewendet werden soll, wenn die aktuelle Fensterbreite = 720 effektive Pixel ist >und die aktuelle Fensterhöhe = 900 effektive Pixel ist >.
<AdaptiveTrigger MinWindowWidth="720" MinWindowHeight="900"/>
Konstruktoren
| Name | Beschreibung |
|---|---|
| AdaptiveTrigger() |
Initialisiert eine neue Instanz der AdaptiveTrigger-Klasse |
Eigenschaften
| Name | Beschreibung |
|---|---|
| Dispatcher |
Gibt immer in einer Windows App SDK-App zurück |
| DispatcherQueue |
Ruft ab |
| MinWindowHeight |
Ruft die minimale Fensterhöhe ab, auf die visualState angewendet werden soll, oder legt diese fest. |
| MinWindowHeightProperty |
Identifies the MinWindowHeight dependency property. |
| MinWindowWidth |
Ruft die minimale Fensterbreite ab, auf die VisualState angewendet werden soll, oder legt diese fest. |
| MinWindowWidthProperty |
Identifies the MinWindowWidth dependency property. |
Methoden
| Name | Beschreibung |
|---|---|
| ClearValue(DependencyProperty) |
Löscht den lokalen Wert einer Abhängigkeitseigenschaft. (Geerbt von DependencyObject) |
| GetAnimationBaseValue(DependencyProperty) |
Gibt einen Basiswert zurück, der für eine Abhängigkeitseigenschaft eingerichtet wurde, was in Fällen angewendet wird, in denen eine Animation nicht aktiv ist. (Geerbt von DependencyObject) |
| GetValue(DependencyProperty) |
Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft aus einem DependencyObject zurück. (Geerbt von DependencyObject) |
| ReadLocalValue(DependencyProperty) |
Gibt den lokalen Wert einer Abhängigkeitseigenschaft zurück, wenn ein lokaler Wert festgelegt wird. (Geerbt von DependencyObject) |
| RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback) |
Registriert eine Benachrichtigungsfunktion, um Änderungen an einer bestimmten DependencyProperty für diese DependencyObject-Instanz zu überwachen. (Geerbt von DependencyObject) |
| SetActive(Boolean) |
Legt den Wert fest, der angibt, ob der Zustandsauslöser aktiv ist. (Geerbt von StateTriggerBase) |
| SetValue(DependencyProperty, Object) |
Legt den lokalen Wert einer Abhängigkeitseigenschaft für ein DependencyObject fest. (Geerbt von DependencyObject) |
| UnregisterPropertyChangedCallback(DependencyProperty, Int64) |
Bricht eine Änderungsbenachrichtigung ab, die zuvor durch Aufrufen von RegisterPropertyChangedCallback registriert wurde. (Geerbt von DependencyObject) |