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ů vizuálního objektu, což je technika, kterou byste mohli chtít použít, pokud jste chtěli serializovat všechny informace o vykreslování hierarchie vizuálních objektů.

// Enumerate all the descendants of the visual object.
static public 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 vizuálního objektu 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 některý typ vizuálního objektu.

WPF podporuje programový přístup k několika různým strukturám stromu objektů. Primárně se zobrazí jako 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í logický strom je implementován 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 najdete v tématu Stromy ve WPF. Logický strom je podporován také podobnou třídou metody nástroje, LogicalTreeHelper.

Metody

GetBitmapEffect(Visual)	BitmapEffect Vrátí hodnotu pro zadanou Visualhodnotu .
GetBitmapEffectInput(Visual)	BitmapEffectInput Vrátí hodnotu pro zadanou Visualhodnotu .
GetCacheMode(Visual)	Načte reprezentaci uložené v mezipaměti zadaného Visualsouboru .
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 položek, které zadaný objekt vizuálu obsahuje.
GetClip(Visual)	Vrátí oblast klipů zadané Visual hodnoty Geometry .
GetContentBounds(Visual)	Vrátí obdélník ohraničujícího rámečku uloženého v mezipaměti pro zadanou Visualhodnotu .
GetContentBounds(Visual3D)	Vrátí obdélník ohraničujícího rámečku uloženého v mezipaměti pro zadanou Visual3Dhodnotu .
GetDescendantBounds(Visual)	Vrátí sjednocení všech ohraničujících polí obsahu pro všechny potomky objektu Visual, který obsahuje rámečky ohraničující obsah .Visual
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í pole obsahu .Visual3D
GetDpi(Visual)	Získá informace DPI, ve kterých se tento vizuál měří a vykresluje.
GetDrawing(Visual)	Vrátí obsah výkresu 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 hodnoty Visual.
GetOpacity(Visual)	Vrátí neprůhlednost Visual.
GetOpacityMask(Visual)	Brush Vrátí hodnotu, která představuje neprůhlednou masku 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řadnic Y (vodorovné).
HitTest(Visual, HitTestFilterCallback, HitTestResultCallback, HitTestParameters)	Inicializuje test hit na zadaném Visual, s volajícím definovanými HitTestFilterCallback a HitTestResultCallback metodami.
HitTest(Visual, Point)	Vrátí nejvrchnější Visual objekt testu hitu zadáním parametru Point.
HitTest(Visual3D, HitTestFilterCallback, HitTestResultCallback, HitTestParameters3D)	Inicializuje test hit na zadaném Visual3D, s volajícím definovanými HitTestFilterCallback a HitTestResultCallback metodami.
SetRootDpi(Visual, DpiScale)	Aktualizuje informace o DPI vizuálu. Dá se volat jenom ve vizuálu bez nadřazeného objektu.