VisualTreeHelper 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
提供執行視覺樹中節點常見任務的工具方法。
public ref class VisualTreeHelper abstract sealed
public static class VisualTreeHelper
type VisualTreeHelper = class
Public Class VisualTreeHelper
- 繼承
-
VisualTreeHelper
範例
下列範例示範如何列舉視覺物件的所有子系,如果您對將視覺物件階層的所有轉譯資訊序列化感興趣,這也會是您想要使用的技術。
// Enumerate all the descendants of the visual object.
public static void EnumVisual(Visual myVisual)
{
for (int i = 0; i < VisualTreeHelper.GetChildrenCount(myVisual); i++)
{
// Retrieve child visual at specified index value.
Visual childVisual = (Visual)VisualTreeHelper.GetChild(myVisual, i);
// Do processing of the child visual object.
// Enumerate children of the child visual object.
EnumVisual(childVisual);
}
}
' Enumerate all the descendants of the visual object.
Public Shared Sub EnumVisual(ByVal myVisual As Visual)
For i As Integer = 0 To VisualTreeHelper.GetChildrenCount(myVisual) - 1
' Retrieve child visual at specified index value.
Dim childVisual As Visual = CType(VisualTreeHelper.GetChild(myVisual, i), Visual)
' Do processing of the child visual object.
' Enumerate children of the child visual object.
EnumVisual(childVisual)
Next i
End Sub
備註
視覺樹中的節點可以是 Visual 物件 Visual3D 或物件。 特定於某一視覺物件類型的方法類型為 VisualVisual3D或 。 然而,類別 VisualTreeHelper 中的某些方法可以接受 DependencyObject 代表任一視覺物件類型的值。
WPF 支援對多種不同物件樹狀結構的程式存取。 主要,這會被呈現為視覺樹和邏輯樹。 在某些情況下,邏輯樹是 WPF 應用程式中元素的更實用表示,但從概念上來說,邏輯樹是在類別之外 Visual 的層級實作。 與視覺樹不同,邏輯樹可以表示非視覺的資料物件,例如 ListItem。 如需有關邏輯樹的更多資訊,請參閱