EventTrigger クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
イベントに応答して一連のアクション (アニメーション ストーリーボード) を適用するトリガーを表します。 一般的に使用されません。 「解説」を参照してください。
public ref class EventTrigger sealed : TriggerBase
/// [Microsoft.UI.Xaml.Markup.ContentProperty(Name="Actions")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
/// [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 EventTrigger final : TriggerBase
[Microsoft.UI.Xaml.Markup.ContentProperty(Name="Actions")]
[Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
[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 sealed class EventTrigger : TriggerBase
Public NotInheritable Class EventTrigger
Inherits TriggerBase
- 継承
- 属性
例
この 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 の互換性のために存在します。 イベント トリガーが以前に使用されていたほとんどのシナリオでは、次のいずれかの操作を行います。
- アニメーション ライブラリの組み込みアニメーションを使用します。 「XAML のアニメーション」を参照してください。
- コントロール テンプレート内のイベントの場合は、ビジュアル状態と VisualStateManager を使用します。 「XAML コントロール テンプレート」を参照してください。
- アプリ固有の UI アニメーションの場合は、ページで Loaded ハンドラーを定義します。 このハンドラーは、ページ レベルのリソースで定義されているストーリーボードを参照し、そのストーリーボードで Begin メソッドを呼び出すことができます。 ストーリーボード化されたアニメーションに関するページを参照してください。
トリガーを使用する場合、Windows ランタイム XAML では、イベント トリガーの既定の動作と、EventTrigger の呼び出しに使用できる唯一のイベントは FrameworkElement.Loaded です。 これは既定の動作と唯一有効な動作の両方であるため、 RoutedEvent 属性は設定しないでください。 XAML <EventTrigger>
を使用するだけです。
RoutedEvent を明示的に設定した場合 (推奨されません)、動作する XAML は のみです<EventTrigger RoutedEvent="FrameworkElement.Loaded">
。 修飾されていない "Loaded" またはその他の値は、解析例外をスローします。 詳細については、「 トリガー」を参照してください。
コンストラクター
EventTrigger() |
EventTrigger クラスの新しいインスタンスを初期化します。 |
プロパティ
Actions |
この EventTrigger が保持する BeginStoryboard オブジェクトのコレクションを取得します。 |
Dispatcher |
常に Windows アプリ SDK アプリで を返します |
DispatcherQueue |
このオブジェクトが |
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) |