VisualTreeHelper Kelas

Definisi

Ruang nama:

System.Windows.Media

Rakitan:

PresentationCore.dll

Menyediakan metode utilitas yang melakukan tugas umum yang melibatkan simpul di pohon visual.

public ref class VisualTreeHelper abstract sealed

public static class VisualTreeHelper

type VisualTreeHelper = class

Public Class VisualTreeHelper

Warisan

Object

VisualTreeHelper

Contoh

Contoh berikut menunjukkan cara menghitung semua turunan objek visual, yang merupakan teknik yang mungkin ingin Anda gunakan jika Anda tertarik untuk menserialisasikan semua informasi penyajian hierarki objek visual.

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

Keterangan

Simpul di pohon visual dapat berupa Visual objek atau Visual3D . Metode yang khusus untuk jenis objek visual dititikkan sebagai Visual atau Visual3D. Namun, beberapa metode di VisualTreeHelper kelas dapat menerima DependencyObject nilai yang mewakili salah satu jenis objek visual.

WPF mendukung akses terprogram ke beberapa struktur pohon objek yang berbeda. Terutama, ini diekspos sebagai pohon visual dan pohon logis. Dalam beberapa kasus, pohon logis adalah representasi elemen yang lebih berguna dalam aplikasi WPF, tetapi secara konseptual pohon logis diimplementasikan pada tingkat di luar Visual kelas. Tidak seperti pohon visual, pohon logis dapat mewakili objek data nonvisual, seperti ListItem. Untuk informasi selengkapnya tentang pohon logis, lihat Pohon di WPF. Pohon logis juga didukung oleh kelas metode utilitas serupa, LogicalTreeHelper.

Metode

Nama	Deskripsi
GetBitmapEffect(Visual)	Mengembalikan BitmapEffect nilai untuk Visual.
GetBitmapEffectInput(Visual)	Mengembalikan BitmapEffectInput nilai untuk Visual.
GetCacheMode(Visual)	Mengambil representasi cache dari yang ditentukan Visual.
GetChild(DependencyObject, Int32)	Mengembalikan objek visual anak dari indeks koleksi yang ditentukan dalam induk tertentu.
GetChildrenCount(DependencyObject)	Mengembalikan jumlah anak yang berisi objek visual yang ditentukan.
GetClip(Visual)	Mengembalikan wilayah klip yang ditentukan Visual sebagai Geometry nilai.
GetContentBounds(Visual)	Mengembalikan persegi panjang kotak pembatas yang di-cache untuk Visual.
GetContentBounds(Visual3D)	Mengembalikan persegi panjang kotak pembatas yang di-cache untuk Visual3D.
GetDescendantBounds(Visual)	Mengembalikan penyatuan semua kotak pembatas konten untuk semua turunan , yang menyertakan kotak pembatas Visualkonten dari Visual.
GetDescendantBounds(Visual3D)	Mengembalikan gabungan semua kotak pembatas konten untuk semua turunan dari yang ditentukan Visual3D, yang menyertakan kotak pembatas konten dari Visual3D.
GetDpi(Visual)	Mendapatkan informasi DPI di mana Visual ini diukur dan dirender.
GetDrawing(Visual)	Mengembalikan konten gambar dari yang ditentukan Visual.
GetEdgeMode(Visual)	Mengembalikan mode tepi yang ditentukan Visual sebagai EdgeMode nilai.
GetEffect(Visual)	Mendapatkan efek bitmap untuk yang ditentukan Visual.
GetOffset(Visual)	Mengembalikan offset dari Visual.
GetOpacity(Visual)	Mengembalikan opacity dari Visual.
GetOpacityMask(Visual)	Mengembalikan Brush nilai yang mewakili masker opasitas dari Visual.
GetParent(DependencyObject)	Mengembalikan DependencyObject nilai yang mewakili induk objek visual.
GetTransform(Visual)	Mengembalikan Transform nilai untuk Visual.
GetXSnappingGuidelines(Visual)	Mengembalikan kumpulan pedoman koordinat X (vertikal).
GetYSnappingGuidelines(Visual)	Mengembalikan kumpulan pedoman koordinat Y (horizontal).
HitTest(Visual, HitTestFilterCallback, HitTestResultCallback, HitTestParameters)	Memulai tes hit pada , yang ditentukan Visualdengan metode dan HitTestFilterCallback yang ditentukan HitTestResultCallback pemanggil.
HitTest(Visual, Point)	Mengembalikan objek paling Visual atas dari tes hit dengan menentukan Point.
HitTest(Visual3D, HitTestFilterCallback, HitTestResultCallback, HitTestParameters3D)	Memulai tes hit pada , yang ditentukan Visual3Ddengan metode dan HitTestFilterCallback yang ditentukan HitTestResultCallback pemanggil.
SetRootDpi(Visual, DpiScale)	Memperbarui informasi DPI Visual. Ini hanya dapat dipanggil pada Visual tanpa induk.