Introduces DisplayRotationStateTrigger, a new state trigger that provides granular control over device display rotation states. Unlike OrientationStateTrigger which only differentiates between portrait and landscape orientations, this trigger responds to specific rotation angles (0°, 90°, 180°, 270°).

Overview

This new trigger enables developers to create visual states that are triggered based on the device's exact display rotation, providing more precise control for applications that need to respond differently to specific rotation states.

Key Features

Granular Rotation Control:

• Rotation0 (0°) - Device in natural position
• Rotation90 (90°) - Device rotated 90 degrees
• Rotation180 (180°) - Device upside down
• Rotation270 (270°) - Device rotated 270 degrees
• Unknown - Unknown rotation state

Responsive Design:

• Automatically responds to device rotation changes via DeviceDisplay.MainDisplayInfoChanged
• Proper lifecycle management with event subscription/unsubscription
• Design-time support with DesignMode.IsDesignModeEnabled check

Developer Experience:

• Complete inline XML documentation with comprehensive XAML examples
• Full nullable reference type compliance
• Comprehensive unit test coverage with 6 test methods
• Working sample implementation in Controls.Sample

Use Cases

Perfect for applications requiring specific rotation-based layouts:

• Games with different UI layouts for each rotation state
• Apps needing to handle upside-down orientations differently from normal portrait
• Complex responsive designs requiring granular rotation control
• Applications with rotation-specific features or constraints

Sample Usage

<VisualState Name="UpsideDown">
    <VisualState.StateTriggers>
        <DisplayRotationStateTrigger Rotation="Rotation180" />
    </VisualState.StateTriggers>
    <VisualState.Setters>
        <Setter Property="BackgroundColor" Value="Red" />
    </VisualState.Setters>
</VisualState>

Implementation Details

• Follows the same architectural patterns as existing state triggers (OrientationStateTrigger, DeviceStateTrigger)
• Includes comprehensive unit tests covering all rotation combinations, property changes, device rotation changes, and lifecycle management
• Integrated sample in StateTriggersPage.xaml demonstrates practical usage with different background colors for each rotation state
• PublicAPI files updated for all target platforms

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.