FrameworkElement.Triggers プロパティ

定義

この要素に直接、または子要素で設定されているトリガーのコレクションを取得します。

public:
 property System::Windows::TriggerCollection ^ Triggers { System::Windows::TriggerCollection ^ get(); };
public System.Windows.TriggerCollection Triggers { get; }
member this.Triggers : System.Windows.TriggerCollection
Public ReadOnly Property Triggers As TriggerCollection

プロパティ値

TriggerCollection

厳密に型指定された Trigger オブジェクトのコレクション。

注釈

注意

このプロパティを設定できるのは、表示されているコレクション構文を使用するか、コレクションオブジェクトにアクセスし、Add などのさまざまなメソッドを使用して Extensible Application Markup Language (XAML) だけです。 コレクションオブジェクト自体にアクセスするプロパティは読み取り専用で、コレクション自体は読み取り/書き込み可能です。 プロパティはルート要素にのみ存在します。検索または他の場所に設定しようとすると、例外がスローされます。

このプロパティを使用すると、この要素で使用されているスタイルの一部として存在するトリガーを調べることはできません。 このメソッドは、マークアップまたはコードのいずれかでコレクションに文字どおりに追加されるトリガーのコレクションのみを報告します。 通常、要素には、既定ではそのような要素が存在しません (インスタンスのテンプレートを使用)。これは、コントロールの複合から、代わりにスタイルで設定されるトリガーの方が一般的です。

動作の観点から (そして、要素の宣言されたコレクションに起因する効果を確立しようとすると Triggers )、トリガー条件とトリガー効果の両方がこの要素に存在するか、論理ツリー内の子要素にある可能性があります。 このコレクションを取得するためになどの有効期間イベントを使用する場合は、 Loaded 子要素のトリガーがまだ完全に読み込まれていない可能性があります。また、コレクションは、実際に実行される場合よりも小さくなります。

要素に対して確立されたトリガーのコレクションでは EventTrigger 、プロパティトリガー () ではなく、のみがサポートされていることに注意 Trigger してください。 プロパティトリガーが必要な場合は、これらをスタイルまたはテンプレート内に配置し、プロパティを直接使用するか、暗黙的なスタイル参照を使用して、そのスタイルまたはテンプレートを要素に割り当てる必要があり Style ます。

XAML プロパティ要素の使用

<object>  
  <object.Triggers>  
    oneOrMoreTriggers  
  </object.Triggers>  
</object>  

XAML 値

oneOrMoreTriggers
1つ以上の定義済み EventTrigger の要素。 このようなトリガーには、有効なストーリーボードアクションと参照が含まれている必要があります。 このコレクションは、ページのルート要素でのみ設定できることに注意してください。 詳細については、「ストーリーボードの概要」を参照してください。

適用対象

こちらもご覧ください