VisualTreeHelper Osztály

Definíció

Névtér:

System.Windows.Media

Szerelvény:

PresentationCore.dll

Olyan segédprogram-metódusokat biztosít, amelyek a vizualizációfán lévő csomópontokat érintő gyakori feladatokat hajtanak végre.

public ref class VisualTreeHelper abstract sealed

public static class VisualTreeHelper

type VisualTreeHelper = class

Public Class VisualTreeHelper

Öröklődés

Object

VisualTreeHelper

Példák

Az alábbi példa bemutatja, hogyan lehet számba venni egy vizualizációs objektum összes leszármazottját. Ezt a technikát érdemes lehet használni, ha egy vizualizációs objektumhierarchia összes renderelési információját szeretné szerializálni.

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

Megjegyzések

A vizualizációfa csomópontjai lehetnek objektumok Visual vagy Visual3D objektumok. A vizualizációs objektumok típusára jellemző metódusok vagy VisualVisual3D. Az osztály egyes metódusai VisualTreeHelper azonban elfogadhatnak egy DependencyObject olyan értéket, amely a vizualizáció egyik típusát jelöli.

WPF támogatja az objektumok különböző fastruktúráihoz való programozott hozzáférést. Ez elsősorban vizuális faként és logikai faként jelenik meg. Bizonyos esetekben a logikai fa egy WPF alkalmazás elemeinek hasznosabb ábrázolása, de elméletileg a logikai fa a Visual osztályon túli szinten van implementálva. A vizualizációs fával ellentétben a logikai fa nemvisuális adatobjektumokat, például ListItem. További információ a logikai fáról az alábbi hivatkozásnál található: Fák a WPF. A logikai fát egy hasonló segédprogram-metódusosztály is támogatja. LogicalTreeHelper

Metódusok

Name	Description
GetBitmapEffect(Visual)	BitmapEffect A megadott Visualérték értékét adja vissza.
GetBitmapEffectInput(Visual)	BitmapEffectInput A megadott Visualérték értékét adja vissza.
GetCacheMode(Visual)	Lekéri a megadott Visualgyorsítótárazott ábrázolását.
GetChild(DependencyObject, Int32)	A gyermekvizualizáció objektumát adja vissza a megadott gyűjteményindexből egy adott szülőn belül.
GetChildrenCount(DependencyObject)	A megadott vizualizációobjektum által tartalmazott gyermekek számát adja vissza.
GetClip(Visual)	Adja vissza a megadott Visual klipterületet értékként Geometry .
GetContentBounds(Visual)	A megadotthoz Visualtartozó gyorsítótárazott határolókeret téglalapot adja vissza.
GetContentBounds(Visual3D)	A megadotthoz Visual3Dtartozó gyorsítótárazott határolókeret téglalapot adja vissza.
GetDescendantBounds(Visual)	Az összes tartalomhatároló mező egyesítését adja vissza a leszármazók Visualszámára, amely magában foglalja a tartalom határolókeretét Visualis.
GetDescendantBounds(Visual3D)	A megadott Visual3Dleszármazottakhoz tartozó összes tartalomhatároló mező egyesítését adja vissza, amely magában foglalja a tartalom határolókeretét Visual3Dis.
GetDpi(Visual)	Lekéri azokat a DPI-információkat, amelyeken a vizualizációt mérni és renderelni kell.
GetDrawing(Visual)	A megadott Visualrajztartalom visszaadása.
GetEdgeMode(Visual)	A megadott VisualEdgeMode érték élmódját adja vissza.
GetEffect(Visual)	Lekéri a megadott Visualbitképeffektust.
GetOffset(Visual)	A függvény eltolását Visualadja vissza.
GetOpacity(Visual)	A átlátszatlanságát Visualadja vissza.
GetOpacityMask(Visual)	A Brush átlátszatlansági maszkját Visualjelképező értéket ad vissza.
GetParent(DependencyObject)	Olyan értéket ad DependencyObject vissza, amely a vizualizáció objektum szülőjének felel meg.
GetTransform(Visual)	Értéket ad Transform vissza a . értékének Visual.
GetXSnappingGuidelines(Visual)	Egy X-koordináta (függőleges) útmutatógyűjteményt ad vissza.
GetYSnappingGuidelines(Visual)	Y koordinátájú (vízszintes) útmutatógyűjteményt ad vissza.
HitTest(Visual, HitTestFilterCallback, HitTestResultCallback, HitTestParameters)	A megadott Visual, hívó által definiált HitTestFilterCallback és HitTestResultCallback metódusokkal rendelkező találattesztet kezdeményez.
HitTest(Visual, Point)	Egy találati teszt legfelső Visual objektumát adja vissza egy Point.
HitTest(Visual3D, HitTestFilterCallback, HitTestResultCallback, HitTestParameters3D)	A megadott Visual3D, hívó által definiált HitTestFilterCallback és HitTestResultCallback metódusokkal rendelkező találattesztet kezdeményez.
SetRootDpi(Visual, DpiScale)	Frissíti egy vizualizáció DPI-információit. Csak szülő nélküli vizualizációkon hívható meg.