EventTrigger クラス

定義

名前空間:

Windows.UI.Xaml

イベントに応答して一連のアクション (アニメーション ストーリーボード) を適用するトリガーを表します。 一般的に使用されません。 「解説」を参照してください。

public ref class EventTrigger sealed : TriggerBase

/// [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)]
/// [Windows.UI.Xaml.Markup.ContentProperty(Name="Actions")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class EventTrigger final : TriggerBase

[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)]
[Windows.UI.Xaml.Markup.ContentProperty(Name="Actions")]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class EventTrigger : TriggerBase

Public NotInheritable Class EventTrigger
Inherits TriggerBase

<EventTrigger>
  oneOrMoreBeginStoryboards
</EventTrigger>
 

継承

Object Platform::Object IInspectable DependencyObject TriggerBase EventTrigger

属性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute ContentPropertyAttribute

Windows の要件

デバイス ファミリ	Windows 10 (10.0.10240.0 で導入)
API contract	Windows.Foundation.UniversalApiContract (v1.0 で導入)

例

この XAML の例では、既定の FrameworkElement.Loaded トリガー動作で FrameworkElement.Triggers を使用してストーリーボード化されたアニメーションを実行するための基本的な構造を示します。 この XAML は、XAML コンテンツ プロパティ構文と不要なプロパティ要素タグを省略して、それぞれのコンテナー要素と適切な関係にある EventTrigger および BeginStoryboard コンテナー要素を示します。

<Canvas Width="200" Height="200" x:Name="animatedcanvas" Background="Red">
    <Canvas.Triggers>
        <EventTrigger>
            <BeginStoryboard>
                <Storyboard x:Name="ColorStoryboard">
                   <!-- Animate the background of the canvas to green over 4 seconds. -->
                    <ColorAnimation Storyboard.TargetName="animatedcanvas"
                      Storyboard.TargetProperty="(Panel.Background).(SolidColorBrush.Color)"
                      To="Green" Duration="0:0:4"/>
                </Storyboard>
            </BeginStoryboard>
        </EventTrigger>
    </Canvas.Triggers>
</Canvas>

注釈

トリガー、EventTrigger、 Actions 、 BeginStoryboard は一般的には使用されません。 これらの API は、主に Microsoft Silverlight で最初に使用された XAML の互換性のために存在します。 イベント トリガーが以前に使用されていたほとんどのシナリオでは、次のいずれかの操作を行います。

• アニメーション ライブラリの組み込みアニメーションを使用します。 「クイック スタート: アニメーション ライブラリを使用して UI をアニメーション化する」を参照してください。
• コントロール テンプレート内のイベントの場合は、ビジュアル状態と VisualStateManager を使用します。 「表示状態のストーリーボード付きアニメーション」または「クイック スタート: コントロール テンプレート」を参照してください。
• アプリ固有の UI アニメーションの場合は、ページで Loaded ハンドラーを定義します。 このハンドラーは、ページ レベルのリソースで定義されているストーリーボードを参照し、そのストーリーボードで Begin メソッドを呼び出すことができます。 ストーリーボード化されたアニメーションに関するページを参照してください。

トリガーを使用する場合、Windows ランタイム XAML では、イベント トリガーの既定の動作と、EventTrigger の呼び出しに使用できる唯一のイベントは FrameworkElement.Loaded です。 これは既定の動作と唯一有効な動作の両方であるため、 RoutedEvent 属性は設定しないでください。 XAML <EventTrigger>を使用するだけです。 RoutedEvent を明示的に設定した場合 (推奨されません)、動作する XAML は のみです<EventTrigger RoutedEvent="FrameworkElement.Loaded">。 修飾されていない "Loaded" またはその他の値は、解析例外をスローします。 詳細については、「 トリガー」を参照してください。

コンストラクター

EventTrigger()

EventTrigger クラスの新しいインスタンスを初期化します。

プロパティ

Actions	この EventTrigger が保持する BeginStoryboard オブジェクトのコレクションを取得します。
Dispatcher	このオブジェクトが関連付けられている CoreDispatcher を取得します。 CoreDispatcher は、コードが UI 以外のスレッドによって開始された場合でも、UI スレッド上の DependencyObject にアクセスできる機能を表します。 (継承元 DependencyObject)
RoutedEvent	トリガーを開始するイベントの名前を取得または設定します。 一般的には設定されていません。「解説」を参照してください。

メソッド

ClearValue(DependencyProperty)	依存関係プロパティのローカル値をクリアします。 (継承元 DependencyObject)
GetAnimationBaseValue(DependencyProperty)	依存関係プロパティに対して確立された基本値を返します。これは、アニメーションがアクティブでない場合に適用されます。 (継承元 DependencyObject)
GetValue(DependencyProperty)	DependencyObject から依存関係プロパティの現在の有効な値を返します。 (継承元 DependencyObject)
ReadLocalValue(DependencyProperty)	ローカル値が設定されている場合は、依存関係プロパティのローカル値を返します。 (継承元 DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	この DependencyObject インスタンスの特定の DependencyProperty に対する変更をリッスンするための通知関数を登録します。 (継承元 DependencyObject)
SetValue(DependencyProperty, Object)	DependencyObject の依存関係プロパティのローカル値を設定します。 (継承元 DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	RegisterPropertyChangedCallback を呼び出して以前に登録した変更通知を取り消します。 (継承元 DependencyObject)

こちらもご覧ください

• TriggerBase
• Triggers
• 表示状態用にストーリーボードに設定されたアニメーション
• クイック スタート: コントロール テンプレート