FrameworkElement.ApplyTemplate メソッド


必要に応じて現在のテンプレートのビジュアル ツリーを構築し、この呼び出しによってビジュアル ツリーが再構築されたかどうかを示す値を返します。Builds the current template's visual tree if necessary, and returns a value that indicates whether the visual tree was rebuilt by this call.

 bool ApplyTemplate();
public bool ApplyTemplate ();
member this.ApplyTemplate : unit -> bool
Public Function ApplyTemplate () As Boolean



ビジュアルがツリーに追加された場合は true、それ以外の場合は false を返します。true if visuals were added to the tree; returns false otherwise.


アプリケーションはこのメソッドを呼び出して、要素のビジュアルツリーが完全であることを保証できます。Applications can call this method to guarantee that the visual tree of an element is complete. この保証手順は、コードがツリー内の子要素をチェックする場合に必要になることがあります。This guarantee step might be necessary if code will be checking the child elements in the tree. アプリケーション内の一般的な要素ロジックでは、を呼び出す ApplyTemplate 必要はありません。これは、テンプレートが有効期間の適切な位置にある要素に自動的に適用されるためです。For typical element logic within applications, calling ApplyTemplate is not necessary, because templates will be applied to elements at an appropriate point in their lifetimes automatically.

ApplyTemplate は、WPF フレームワークレベルのレイアウトシステムによって、すべてのメジャーパスで呼び出されます。ApplyTemplate is called on every Measure pass by the WPF framework-level layout system.

FrameworkElement 派生クラスは、クラスハンドラーを使用し OnApplyTemplate て、このメソッドが明示的に呼び出された場合、またはレイアウトシステムによって呼び出された場合に通知を受け取ることができます。FrameworkElement derived classes can use the OnApplyTemplate class handler to be notified of cases where this method was called explicitly, or by the layout system. OnApplyTemplate は、テンプレートが完全に生成され、論理ツリーにアタッチされた後に呼び出されます。OnApplyTemplate is called after the template is completely generated and attached to the logical tree.