LogicalTreeHelper LogicalTreeHelper LogicalTreeHelper LogicalTreeHelper Class

定義

論理ツリー内のオブジェクトのクエリを実行するために静的ヘルパー メソッドを提供します。Provides static helper methods for querying objects in the logical tree.

public ref class LogicalTreeHelper abstract sealed
public static class LogicalTreeHelper
type LogicalTreeHelper = class
Public Class LogicalTreeHelper
継承
LogicalTreeHelperLogicalTreeHelperLogicalTreeHelperLogicalTreeHelper

注釈

クラスLogicalTreeHelperには、オブジェクトの子コレクションを返すために使用するメソッド、または論理ツリーのサブノード内から特定のオブジェクトを返すためのメソッドが用意されています。The LogicalTreeHelper class provides methods that you can use to return child collections of objects, or specific objects from within subnodes of the logical tree. ただし、通常実行するオブジェクトツリー操作の多くは、またはFrameworkElement FrameworkContentElementの同様のメソッドまたはプロパティによっても公開されます。However, most of the object tree operations that you typically perform are also exposed by similar methods or properties on FrameworkElement or FrameworkContentElement. たとえば、次のようにします。For example, try the following:

  • 論理子オブジェクトの列挙GetChildren子を返す静的メソッドを呼び出す代わりに、そのオブジェクトのコンテンツモデルで公開されている専用コレクションを使用します。Instead of calling the static GetChildren method, which returns an enumerator for the logical child objects, use the dedicated collection exposed in the content model for that object. コンテンツモデルをサポートするほとんどすべてのオブジェクトは、子オブジェクトのコレクションを含むいくつかのプロパティを公開し、そのコレクションに直接コレクションインターフェイスをサポートします。Nearly all objects that support a content model expose some property that contains the collection of child objects, and provides collection interface support directly on that collection.

  • 静的FindLogicalNodeメソッドを呼び出して、その名前を指定して子オブジェクトを取得する代わりFrameworkElement.FindNameに、特定のオブジェクトに対してメソッドまたはFrameworkContentElement.FindNameメソッドを呼び出します。Instead of calling the static FindLogicalNode method to obtain a child object by specifying its name, call the FrameworkElement.FindName or FrameworkContentElement.FindName method on specific objects.

LogicalTreeHelperは、論理ツリーを複数のレベルで再帰的に上または下に移動し、さまざまな親または子オブジェクトを検査するための一貫した方法を使用する分析シナリオに最も役立ちます。LogicalTreeHelper is most useful for analysis scenarios where you are traveling up or down the logical tree recursively through multiple levels, and want to use a consistent approach for examining the various parent or child objects. この場合、コンテンツモデルが混在していて、より多くのコンテンツモデル固有の Api を使用すると、複雑になる可能性があります。In this case, you might be accessing a mixture of content models, and using the more content-model specific APIs would be too complex.

メソッド

BringIntoView(DependencyObject) BringIntoView(DependencyObject) BringIntoView(DependencyObject) BringIntoView(DependencyObject)

要求された UI 要素の表示を試行して、結果を報告するためにターゲット上で RequestBringIntoView イベントを発生させます。Attempts to bring the requested UI element into view and raises the RequestBringIntoView event on the target in order to report the results.

FindLogicalNode(DependencyObject, String) FindLogicalNode(DependencyObject, String) FindLogicalNode(DependencyObject, String) FindLogicalNode(DependencyObject, String)

指定された名前を持つオブジェクトを検索して返します。Attempts to find and return an object that has the specified name. 検索は指定されたオブジェクトから開始され、論理ツリーのサブノードに続きます。The search starts from the specified object and continues into subnodes of the logical tree.

GetChildren(DependencyObject) GetChildren(DependencyObject) GetChildren(DependencyObject) GetChildren(DependencyObject)

論理ツリーを処理して、指定したオブジェクトの直接の子オブジェクトのコレクションを返します。Returns the collection of immediate child objects of the specified object, by processing the logical tree.

GetChildren(FrameworkContentElement) GetChildren(FrameworkContentElement) GetChildren(FrameworkContentElement) GetChildren(FrameworkContentElement)

論理ツリーを処理して、指定した FrameworkContentElement の直接の子オブジェクトのコレクションを返します。Returns the collection of immediate child objects of the specified FrameworkContentElement by processing the logical tree.

GetChildren(FrameworkElement) GetChildren(FrameworkElement) GetChildren(FrameworkElement) GetChildren(FrameworkElement)

論理ツリーを処理して、指定した FrameworkElement の直接の子オブジェクトのコレクションを返します。Returns the collection of immediate child objects of the specified FrameworkElement by processing the logical tree.

GetParent(DependencyObject) GetParent(DependencyObject) GetParent(DependencyObject) GetParent(DependencyObject)

論理ツリーを処理して、指定したオブジェクトの親オブジェクトを返します。Returns the parent object of the specified object by processing the logical tree.

適用対象