EventTrigger.Actions Property

Definition

Namespace:

System.Windows

Assembly:

PresentationFramework.dll

Gets the collection of actions to apply when the event occurs.

public:
 property System::Windows::TriggerActionCollection ^ Actions { System::Windows::TriggerActionCollection ^ get(); };

public System.Windows.TriggerActionCollection Actions { get; }

member this.Actions : System.Windows.TriggerActionCollection

Public ReadOnly Property Actions As TriggerActionCollection

Property Value

TriggerActionCollection

The default is an empty collection.

Examples

This example describes how to use event triggers in a style to animate the MouseEnter and MouseLeave events of a FrameworkElement. As mentioned above, adding a TriggerAction child to an EventTrigger object implicitly adds it to the TriggerActionCollection for the EventTrigger object. Therefore, in this example, <EventTrigger.Actions> is implicit.

<Style TargetType="Rectangle">
  <Setter Property="Width" Value="50" />
  <Setter Property="Height" Value="50" />
  <Setter Property="Margin" Value="20" />
  <Setter Property="HorizontalAlignment" Value="Left" />
  <Style.Triggers>
    <EventTrigger RoutedEvent="MouseEnter">
        <BeginStoryboard>
            <Storyboard>
              <DoubleAnimation To="300" Duration="0:0:1.5" 
                AccelerationRatio="0.10" DecelerationRatio="0.25" 
                Storyboard.TargetProperty="(Canvas.Width)" />
            </Storyboard>
        </BeginStoryboard>
    </EventTrigger>
    <EventTrigger RoutedEvent="MouseLeave">
        <BeginStoryboard>
            <Storyboard>
              <DoubleAnimation Duration="0:0:1.5" 
                AccelerationRatio="0.10" DecelerationRatio="0.25" 
                Storyboard.TargetProperty="(Canvas.Width)" />
            </Storyboard>
        </BeginStoryboard>
    </EventTrigger>
  </Style.Triggers>
</Style>

Remarks

Unlike Trigger, EventTrigger has no concept of termination of state, so the action will not be undone once the condition that raised the event is no longer true.

Adding a TriggerAction child to an EventTrigger object implicitly adds it to the TriggerActionCollection for the EventTrigger object.

Note

This property can only be set in Extensible Application Markup Language (XAML) via the collection syntax shown, or by accessing the collection object and using its various methods such as Add. The property to access the collection object itself is read-only, the collection itself is read-write.

XAML Property Element Usage

<object>
  <object.Actions>
    OneOrMoreTriggerActions
  </object.Actions>
</object>

XAML Values

OneOrMoreTriggerActions One or more TriggerAction objects.