VisualTreeHelper Třída

Definice

Obor názvů:

System.Windows.Media

Sestavení:

PresentationCore.dll

Poskytuje pomocné metody, které provádějí běžné úlohy zahrnující uzly ve vizuálním stromu.

public ref class VisualTreeHelper abstract sealed

public static class VisualTreeHelper

type VisualTreeHelper = class

Public Class VisualTreeHelper

Dědičnost

Object

VisualTreeHelper

Příklady

Následující příklad ukazuje, jak vytvořit výčet všech potomků objektu vizuálu, což je technika, kterou můžete použít, pokud vás zajímá serializace všech vykreslovacích informací v hierarchii objektů vizuálu.

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

Poznámky

Uzly ve vizuálním stromu můžou být buď Visual nebo Visual3D objekty. Metody specifické pro typ objektu vizuálu jsou zadány jako buď Visual nebo Visual3D. Některé metody ve VisualTreeHelper třídě však mohou přijmout DependencyObject hodnotu, která představuje jeden typ objektu vizuálu.

WPF podporuje programový přístup k několika různým strukturám stromové struktury objektů. Primárně se jedná o vizuální strom a logický strom. V některých případech je logický strom užitečnější reprezentací prvků v aplikaci WPF, ale koncepčně se logický strom implementuje na úrovni nad Visual třídou. Na rozdíl od vizuálního stromu může logický strom představovat nevisuální datové objekty, například ListItem. Další informace o logickém stromu naleznete v tématu Stromy ve WPF. Logický strom je podporován také podobnou třídou metody utility , LogicalTreeHelper.

Metody

Name	Description
GetBitmapEffect(Visual)	BitmapEffect Vrátí hodnotu pro zadanou Visualhodnotu .
GetBitmapEffectInput(Visual)	BitmapEffectInput Vrátí hodnotu pro zadanou Visualhodnotu .
GetCacheMode(Visual)	Načte reprezentaci zadaného souboru Visualv mezipaměti .
GetChild(DependencyObject, Int32)	Vrátí podřízený objekt vizuálu ze zadaného indexu kolekce v rámci zadaného nadřazeného objektu.
GetChildrenCount(DependencyObject)	Vrátí počet podřízených objektů, které zadaný objekt vizuálu obsahuje.
GetClip(Visual)	Vrátí oblast klipu zadané Visual hodnoty Geometry .
GetContentBounds(Visual)	Vrátí obdélník ohraničujícího rámečku uložené v mezipaměti pro zadaný Visual.
GetContentBounds(Visual3D)	Vrátí obdélník ohraničujícího rámečku uložené v mezipaměti pro zadaný Visual3D.
GetDescendantBounds(Visual)	Vrátí sjednocení všech ohraničujících polí obsahu pro všechny potomky , Visualkteré zahrnují ohraničující rámeček Visualobsahu .
GetDescendantBounds(Visual3D)	Vrátí sjednocení všech ohraničujících polí obsahu pro všechny potomky zadaného Visual3Dobjektu , který zahrnuje ohraničující rámeček Visual3Dobsahu .
GetDpi(Visual)	Získá informace DPI, při kterých se tento vizuál měří a vykresluje.
GetDrawing(Visual)	Vrátí nakreslený obsah zadaného Visualobjektu .
GetEdgeMode(Visual)	Vrátí hraniční režim zadané Visual hodnoty EdgeMode .
GetEffect(Visual)	Získá rastrový efekt pro zadaný Visual.
GetOffset(Visual)	Vrátí posun posunu Visual.
GetOpacity(Visual)	Vrátí neprůhlednost Visual.
GetOpacityMask(Visual)	Brush Vrátí hodnotu, která představuje neprůhlednou masku objektu Visual.
GetParent(DependencyObject)	DependencyObject Vrátí hodnotu, která představuje nadřazený objekt vizuálu.
GetTransform(Visual)	Transform Vrátí hodnotu pro Visualhodnotu .
GetXSnappingGuidelines(Visual)	Vrátí kolekci vodítek souřadnic X (svisle).
GetYSnappingGuidelines(Visual)	Vrátí kolekci vodítek souřadnice Y (vodorovné).
HitTest(Visual, HitTestFilterCallback, HitTestResultCallback, HitTestParameters)	Inicializuje hit test na zadaném Visual, s volajícím definovanými HitTestFilterCallback a HitTestResultCallback metodami.
HitTest(Visual, Point)	Vrátí nejvyšší Visual objekt testu hitu zadáním .Point
HitTest(Visual3D, HitTestFilterCallback, HitTestResultCallback, HitTestParameters3D)	Inicializuje hit test na zadaném Visual3D, s volajícím definovanými HitTestFilterCallback a HitTestResultCallback metodami.
SetRootDpi(Visual, DpiScale)	Aktualizuje informace o DPI vizuálu. Je možné ji volat pouze ve vizuálu bez nadřazeného objektu.