VisualTreeHelper Sınıf

Tanım

Ad Alanı:

System.Windows.Media

Bütünleştirilmiş Kod:

PresentationCore.dll

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

Object

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 nasıl numaralandırılır gösterilmektedir.

// 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 Visual nesneler olabilirVisual3D. Bir görsel nesne türüne özgü yöntemler veya Visualolarak Visual3D 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. WPFAğaçları. Mantıksal ağaç da benzer bir yardımcı program yöntemi sınıfı tarafından desteklenir: LogicalTreeHelper.

Yöntemler

Name	Description
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çinde 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 tüm alt öğeleri Visualiçin tüm içerik sınırlayıcı kutularının birleşimini döndürür. Bu, öğesinin içerik sınırlayıcı kutusunu Visualiçerir.
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, öğesinin içerik sınırlayıcı kutusunu Visual3Diçerir.
GetDpi(Visual)	Bu Görselin ölçüldiği ve işlendiği DPI bilgilerini alır.
GetDrawing(Visual)	Belirtilen Visualöğesinin çizim içeriğini döndürür.
GetEdgeMode(Visual)	Belirtilen Visual öğesinin kenar modunu değer EdgeMode olarak döndürür.
GetEffect(Visual)	Belirtilen Visualiçin bit eşlem efektini alır.
GetOffset(Visual)	öğesinin uzaklığını Visualdöndürür.
GetOpacity(Visual)	öğesinin opaklığını Visualdöndürür.
GetOpacityMask(Visual)	opaklık maskesini Brushtemsil eden bir Visual 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 Transformbir Visual değer döndürür.
GetXSnappingGuidelines(Visual)	Bir X koordinatı (dikey) kılavuz koleksiyonu döndürür.
GetYSnappingGuidelines(Visual)	Y koordinatı (yatay) 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 Visualisabet testinin en üstteki Point 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ştirir. Yalnızca üst öğesi olmayan bir Görselde çağrılabilir.