VisualTreeHelper Klasa

Definicja

Przestrzeń nazw:

System.Windows.Media

Zestaw:

PresentationCore.dll

Udostępnia metody narzędziowe, które wykonują typowe zadania związane z węzłami w drzewie wizualnym.

public ref class VisualTreeHelper abstract sealed

public static class VisualTreeHelper

type VisualTreeHelper = class

Public Class VisualTreeHelper

Dziedziczenie

Object

VisualTreeHelper

Przykłady

W poniższym przykładzie pokazano, jak wyliczyć wszystkie elementy podrzędne obiektu wizualizacji, która jest techniką, której można użyć, jeśli interesuje Cię serializacja wszystkich informacji renderowania hierarchii obiektów wizualizacji.

// 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

Uwagi

Węzły w drzewie wizualizacji mogą być obiektami Visual lub .Visual3D Metody specyficzne dla typu obiektu wizualnego są wpisywane jako Visual lub Visual3D. Jednak niektóre metody w VisualTreeHelper klasie mogą akceptować wartość reprezentującą DependencyObject dowolny typ obiektu wizualnego.

WPF obsługuje programowy dostęp do kilku różnych struktur drzewa obiektów. Przede wszystkim jest to widoczne jako drzewo wizualne i drzewo logiczne. W niektórych przypadkach drzewo logiczne jest bardziej przydatną reprezentacją elementów w aplikacji WPF, ale koncepcyjnie drzewo logiczne jest implementowane na poziomie poza klasą Visual . W przeciwieństwie do drzewa wizualnego drzewo logiczne może reprezentować nievisualne obiekty danych, takie jak ListItem. Aby uzyskać więcej informacji na temat drzewa logicznego, zobacz Drzewa w WPF. Drzewo logiczne jest również obsługiwane przez podobną klasę metody narzędziowej . LogicalTreeHelper

Metody

GetBitmapEffect(Visual)	BitmapEffect Zwraca wartość dla określonego Visualelementu .
GetBitmapEffectInput(Visual)	BitmapEffectInput Zwraca wartość dla określonego Visualelementu .
GetCacheMode(Visual)	Pobiera z pamięci podręcznej reprezentację określonego Visualelementu .
GetChild(DependencyObject, Int32)	Zwraca obiekt wizualizacji podrzędnej z określonego indeksu kolekcji w określonym obiekcie nadrzędnym.
GetChildrenCount(DependencyObject)	Zwraca liczbę elementów podrzędnych, które zawiera określony obiekt wizualny.
GetClip(Visual)	Zwróć region klipu określonego Visual jako Geometry wartość.
GetContentBounds(Visual)	Zwraca buforowany prostokąt pola ograniczenia dla określonego Visualelementu .
GetContentBounds(Visual3D)	Zwraca buforowany prostokąt pola ograniczenia dla określonego Visual3Delementu .
GetDescendantBounds(Visual)	Zwraca związek wszystkich pól ograniczenia zawartości dla wszystkich elementów podrzędnych Visualelementu , który zawiera pole ograniczenia zawartości elementu Visual.
GetDescendantBounds(Visual3D)	Zwraca związek wszystkich pól ograniczenia zawartości dla wszystkich elementów podrzędnych określonego Visual3Delementu , który zawiera pole ograniczenia zawartości elementu Visual3D.
GetDpi(Visual)	Pobiera informacje DPI, w których ta wizualizacja jest mierzona i renderowana.
GetDrawing(Visual)	Zwraca zawartość rysunku określonej wartości Visual.
GetEdgeMode(Visual)	Zwraca tryb krawędzi określony Visual jako EdgeMode wartość.
GetEffect(Visual)	Pobiera efekt mapy bitowej dla określonego Visualelementu .
GetOffset(Visual)	Zwraca przesunięcie wartości Visual.
GetOpacity(Visual)	Zwraca nieprzezroczystość obiektu Visual.
GetOpacityMask(Visual)	Zwraca wartość reprezentującą maskę Brush nieprzezroczystości elementu Visual.
GetParent(DependencyObject)	Zwraca wartość reprezentującą DependencyObject element nadrzędny obiektu wizualizacji.
GetTransform(Visual)	Transform Zwraca wartość elementu Visual.
GetXSnappingGuidelines(Visual)	Zwraca kolekcję wskazówek współrzędnych X (pionowo).
GetYSnappingGuidelines(Visual)	Zwraca kolekcję wskazówek współrzędnych Y (poziomo).
HitTest(Visual, HitTestFilterCallback, HitTestResultCallback, HitTestParameters)	Inicjuje test trafienia w określonym Visualobiekcie z metodami zdefiniowanymi przez HitTestFilterCallback obiekt wywołujący.HitTestResultCallback
HitTest(Visual, Point)	Zwraca najbardziej górny Visual obiekt testu trafienia, określając element Point.
HitTest(Visual3D, HitTestFilterCallback, HitTestResultCallback, HitTestParameters3D)	Inicjuje test trafienia w określonym Visual3Dobiekcie z metodami zdefiniowanymi przez HitTestFilterCallback obiekt wywołujący.HitTestResultCallback
SetRootDpi(Visual, DpiScale)	Aktualizacje informacji DPI wizualizacji. Można go wywołać tylko w wizualizacji bez elementu nadrzędnego.