VisualTreeHelper Sınıf

Tanım

Görsel ağaçtaki düğümlerle ilgili yaygın görevleri gerçekleştiren yardımcı program yöntemleri sağlar.

public ref class VisualTreeHelper abstract sealed
public static class VisualTreeHelper
type VisualTreeHelper = class
Public Class VisualTreeHelper
Devralma
VisualTreeHelper

Örnekler

Aşağıdaki örnekte, görsel nesne hiyerarşisinin tüm işleme bilgilerini seri hale getirmek istiyorsanız kullanmak isteyebileceğiniz bir teknik olan görsel nesnenin tüm alt öğeleri numaralandırılır.

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

Açıklamalar

Görsel ağaçtaki düğümler veya Visual3D nesneleri olabilirVisual. Bir görsel nesne türüne özgü yöntemler veya Visual3Dolarak Visual yazılır. Ancak, sınıftaki VisualTreeHelper bazı yöntemler görsel nesnenin her iki türünü de temsil eden bir DependencyObject değeri kabul edebilir.

WPF, nesnelerin birkaç farklı ağaç yapısına programlı erişimi destekler. Öncelikle, bu bir görsel ağaç ve mantıksal ağaç olarak kullanıma sunulur. Bazı durumlarda mantıksal ağaç, WPF uygulamasındaki öğelerin daha kullanışlı bir gösterimidir, ancak kavramsal olarak mantıksal ağaç sınıfın Visual ötesinde bir düzeyde uygulanır. Görsel ağaçtan farklı olarak, mantıksal ağaç gibi ListItemgörsel olmayan veri nesnelerini temsil edebilir. Mantıksal ağaç hakkında daha fazla bilgi için bkz. WPF'deki Ağaçlar. Mantıksal ağaç, benzer bir yardımcı program yöntemi sınıfı tarafından da desteklenir. LogicalTreeHelper

Yöntemler

GetBitmapEffect(Visual)

BitmapEffect Belirtilen Visualdeğerini döndürür.

GetBitmapEffectInput(Visual)

BitmapEffectInput Belirtilen Visualdeğerini döndürür.

GetCacheMode(Visual)

Belirtilen Visualöğesinin önbelleğe alınmış gösterimini alır.

GetChild(DependencyObject, Int32)

Belirtilen üst öğe içindeki belirtilen koleksiyon dizininden alt görsel nesnesini döndürür.

GetChildrenCount(DependencyObject)

Belirtilen görsel nesnenin içerdiği alt öğe sayısını döndürür.

GetClip(Visual)

Belirtilen Visual küçük resim bölgesini değer Geometry olarak döndürür.

GetContentBounds(Visual)

Belirtilen Visualiçin önbelleğe alınmış sınırlayıcı kutu dikdörtgenini döndürür.

GetContentBounds(Visual3D)

Belirtilen Visual3Diçin önbelleğe alınmış sınırlayıcı kutu dikdörtgenini döndürür.

GetDescendantBounds(Visual)

öğesinin içerik sınırlayıcı kutusunu içeren öğesinin tüm alt öğeleri Visualiçin tüm içerik sınırlayıcı kutularının birleşimini Visualdöndürür.

GetDescendantBounds(Visual3D)

Belirtilen Visual3Döğesinin tüm alt öğeleri için tüm içerik sınırlayıcı kutularının birleşimini döndürür. Bu birleşim, öğesinin içerik sınırlayıcı kutusunu Visual3Diçerir.

GetDpi(Visual)

Bu Görselin ölçülüp işlendiği DPI bilgilerini alır.

GetDrawing(Visual)

Belirtilen Visualöğesinin çizim içeriğini döndürür.

GetEdgeMode(Visual)

Değeri olarak EdgeMode belirtilen Visual kenar modunu döndürür.

GetEffect(Visual)

Belirtilen Visualiçin bit eşlem efektini alır.

GetOffset(Visual)

değerinin uzaklığını Visualdöndürür.

GetOpacity(Visual)

öğesinin opaklığını Visualdöndürür.

GetOpacityMask(Visual)

opaklık maskesini Visualtemsil eden bir Brush değer döndürür.

GetParent(DependencyObject)

Görsel nesnenin üst öğesini temsil eden bir DependencyObject değer döndürür.

GetTransform(Visual)

için Visualbir Transform değer döndürür.

GetXSnappingGuidelines(Visual)

Bir X koordinatı (dikey) yönerge koleksiyonu döndürür.

GetYSnappingGuidelines(Visual)

Y koordinatlı (yatay) bir kılavuz koleksiyonu döndürür.

HitTest(Visual, HitTestFilterCallback, HitTestResultCallback, HitTestParameters)

Belirtilen Visualüzerinde çağıran tanımlı HitTestFilterCallback ve HitTestResultCallback yöntemleriyle bir isabet testi başlatır.

HitTest(Visual, Point)

bir belirterek Pointisabet testinin en üstteki Visual nesnesini döndürür.

HitTest(Visual3D, HitTestFilterCallback, HitTestResultCallback, HitTestParameters3D)

Belirtilen Visual3Düzerinde çağıran tanımlı HitTestFilterCallback ve HitTestResultCallback yöntemleriyle bir isabet testi başlatır.

SetRootDpi(Visual, DpiScale)

Görselin DPI bilgilerini Güncelleştirmeler. Yalnızca üst öğesi olmayan bir Görselde çağrılabilir.

Şunlara uygulanır