Bagikan melalui


VisualTreeHelper Kelas

Definisi

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
VisualTreeHelper

Contoh

Contoh berikut menunjukkan cara menghitung semua turunan objek visual, yang merupakan teknik yang mungkin ingin Anda gunakan jika Anda tertarik untuk membuat serial 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 ditik 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 yang lebih berguna dari elemen 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

GetBitmapEffect(Visual)

Mengembalikan BitmapEffect nilai untuk yang ditentukan Visual.

GetBitmapEffectInput(Visual)

Mengembalikan BitmapEffectInput nilai untuk yang ditentukan 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 dari yang ditentukan Visual sebagai Geometry nilai.

GetContentBounds(Visual)

Mengembalikan persegi kotak pembatas yang di-cache untuk yang ditentukan Visual.

GetContentBounds(Visual3D)

Mengembalikan persegi kotak pembatas yang di-cache untuk yang ditentukan Visual3D.

GetDescendantBounds(Visual)

Mengembalikan penyatuan semua kotak pembatas konten untuk semua turunan , yang menyertakan kotak Visualpembatas Visualkonten .

GetDescendantBounds(Visual3D)

Mengembalikan gabungan semua kotak pembatas konten untuk semua turunan dari yang ditentukan Visual3D, yang menyertakan kotak Visual3Dpembatas konten .

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 tingkat keburaman .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 pengujian hit pada yang ditentukanVisual, dengan metode dan HitTestResultCallback yang ditentukan HitTestFilterCallback pemanggil.

HitTest(Visual, Point)

Mengembalikan objek terbanyak Visual dari tes hit dengan menentukan Point.

HitTest(Visual3D, HitTestFilterCallback, HitTestResultCallback, HitTestParameters3D)

Memulai pengujian hit pada yang ditentukanVisual3D, dengan metode dan HitTestResultCallback yang ditentukan HitTestFilterCallback pemanggil.

SetRootDpi(Visual, DpiScale)

Updates informasi DPI visual. Ini hanya dapat dipanggil pada Visual tanpa induk.

Berlaku untuk