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 ()

注釈

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

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

注意 (継承者)

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

  • 要素ビジュアル ツリーの残りの部分をビルドするコードの独自の実装を呼び出すことができます。

  • テンプレートから派生した名前付き要素への参照を取得するなど、適用されたテンプレートからビジュアル ツリーに依存するコードを実行できます。

  • テンプレートのビジュアル ツリーが完了した後にのみ存在する意味のあるサービスを導入できます。

  • 他の要因に依存するテンプレート内の要素の状態とプロパティを設定できます。 たとえば、プロパティ値は、親要素を知ることや、特定の派生クラスが共通のテンプレートを使用する場合にのみ検出できます。

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

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

適用対象