DisplayRotationStateTrigger Class

Definition

public ref class DisplayRotationStateTrigger sealed : Microsoft::Maui::Controls::StateTriggerBase

public sealed class DisplayRotationStateTrigger : Microsoft.Maui.Controls.StateTriggerBase

type DisplayRotationStateTrigger = class
    inherit StateTriggerBase

Public NotInheritable Class DisplayRotationStateTrigger
Inherits StateTriggerBase

Inheritance

Object

BindableObject

StateTriggerBase

DisplayRotationStateTrigger

Examples

The following example shows how to use DisplayRotationStateTrigger to change the background color based on device rotation:

<ContentPage.Resources>
<Style TargetType="ContentPage">
<Setter Property="VisualStateManager.VisualStateGroups">
<VisualStateGroupList>
<VisualStateGroup>
<VisualState Name="Rotation0">
<VisualState.StateTriggers>
<controls:DisplayRotationStateTrigger Rotation="Rotation0" />
</VisualState.StateTriggers>
<VisualState.Setters>
<Setter Property="BackgroundColor" Value="Red" />
</VisualState.Setters>
</VisualState>
<VisualState Name="Rotation90">
<VisualState.StateTriggers>
<controls:DisplayRotationStateTrigger Rotation="Rotation90" />
</VisualState.StateTriggers>
<VisualState.Setters>
<Setter Property="BackgroundColor" Value="Green" />
</VisualState.Setters>
</VisualState>
<VisualState Name="Rotation180">
<VisualState.StateTriggers>
<controls:DisplayRotationStateTrigger Rotation="Rotation180" />
</VisualState.StateTriggers>
<VisualState.Setters>
<Setter Property="BackgroundColor" Value="Blue" />
</VisualState.Setters>
</VisualState>
<VisualState Name="Rotation270">
<VisualState.StateTriggers>
<controls:DisplayRotationStateTrigger Rotation="Rotation270" />
</VisualState.StateTriggers>
<VisualState.Setters>
<Setter Property="BackgroundColor" Value="Yellow" />
</VisualState.Setters>
</VisualState>
</VisualStateGroup>
</VisualStateGroupList>
</Setter>
</Style>
</ContentPage.Resources>

Remarks

The DisplayRotationStateTrigger enables developers to create visual states that are triggered based on the device's display rotation. Unlike OrientationStateTrigger which only differentiates between portrait and landscape orientations, this trigger provides granular control over specific rotation angles (0°, 90°, 180°, 270°).

This trigger is particularly useful for applications that need to respond to specific device orientations, such as games that have different layouts for each rotation state or apps that need to handle upside-down orientations differently.