FrameworkElement.OnApplyTemplate メソッド

定義

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

派生クラスでオーバーライドされると、アプリケーションコードまたは内部プロセスが ApplyTemplate() を呼び出すたびに呼び出されます。

public:
 virtual void OnApplyTemplate();

public virtual void OnApplyTemplate ();

abstract member OnApplyTemplate : unit -> unit
override this.OnApplyTemplate : unit -> unit

Public Overridable Sub OnApplyTemplate ()

このメソッドには、既定の実装はありません。

テンプレートは、要素に適用されるの Template プロパティから取得される、要素の完成したビジュアルツリーの Style セクションです。詳しくは、「スタイルとテンプレート」をご覧ください。

の FrameworkElement 派生クラスでは、次のメソッドを、考えられるさまざまなシナリオの通知として使用できます。

要素ビジュアルツリーの残りの部分をビルドするコードの独自の実装を呼び出すことができます。
テンプレートから取得した名前付き要素への参照を取得するなど、適用されたテンプレートからビジュアルツリーに依存するコードを実行できます。
テンプレートのビジュアルツリーが完了した後にのみ存在するのが理にかなっているサービスを導入できます。
他の要因に依存するテンプレート内の要素の状態とプロパティを設定できます。たとえば、プロパティ値は、親要素を認識することや、特定の派生クラスが共通テンプレートを使用する場合にのみ検出できる場合があります。

実装者は、常に、独自の実装の前に基本実装を呼び出す必要があります。 FrameworkElement 自体には既定の実装はありませんが、介在するクラスが存在する可能性があります。

Control は、同様のオーバーライドを提供します OnTemplateChanged(ControlTemplate, ControlTemplate)。