FrameworkElement.OnApplyTemplate メソッド

定義

名前空間:

System.Windows

アセンブリ:

PresentationFramework.dll

派生クラスでオーバーライドされると、アプリケーション コードまたは内部プロセスが 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)。