FrameworkElement.GetVisualChild(Int32) Yöntem

Tanım

Ad Alanı:

System.Windows

Bütünleştirilmiş Kod:

PresentationFramework.dll

GetVisualChild(Int32)öğesini geçersiz kılar ve bir alt öğe koleksiyonundan belirtilen dizindeki bir alt öğeyi döndürür.

protected:
 override System::Windows::Media::Visual ^ GetVisualChild(int index);

protected override System.Windows.Media.Visual GetVisualChild (int index);

override this.GetVisualChild : int -> System.Windows.Media.Visual

Protected Overrides Function GetVisualChild (index As Integer) As Visual

Parametreler

index

Int32

Koleksiyonda istenen alt öğenin sıfır tabanlı dizini.

Döndürülenler

Visual

İstenen alt öğe. Bu döndürülmemelidir null; sağlanan dizin aralık dışındaysa bir özel durum oluşturulur.

Örnekler

Aşağıdaki örnekte, bir özel donatıcının birden çok görsel alt öğe için koruduğu bir VisualCollection tarafından bildirilen değerleri nasıl kullandığı gösterilmektedir. Bu değerler ve GetVisualChildgeçersiz kılmaları VisualChildrenCount aracılığıyla bildirilir.

// To store and manage the adorner's visual children.
VisualCollection visualChildren;

' To store and manage the adorner's visual children.
Private visualChildren As VisualCollection

// Override the VisualChildrenCount and GetVisualChild properties to interface with 
// the adorner's visual collection.
protected override int VisualChildrenCount { get { return visualChildren.Count; } }
protected override Visual GetVisualChild(int index) { return visualChildren[index]; }

' Override the VisualChildrenCount and GetVisualChild properties to interface with 
' the adorner's visual collection.
Protected Overrides ReadOnly Property VisualChildrenCount() As Integer
    Get
        Return visualChildren.Count
    End Get
End Property
Protected Overrides Function GetVisualChild(ByVal index As Integer) As Visual
    Return visualChildren(index)
End Function

Açıklamalar

FrameworkElement Uygulamada tek geçerli dizin sıfırdır. için GetVisualChild içerik modeli bir koleksiyonu değil sıfır veya bir alt öğeyi destekler.

Devralanlara Notlar

Bu uygulama yalnızca görsel alt öğelerin daha açıklayıcı bir koleksiyonunu korumayan öğeler için geçerlidir. Böyle bir koleksiyona sahip olan herhangi bir öğenin bu yöntemi geçersiz kılması ve dizini bu öğe tarafından desteklenen alt öğe koleksiyonundaki eşdeğer bir dizinle eşlemesi gerekir. Aralıktaki sıfırdan VisualChildrenCount (eksi bire) kadar olan bir dizin geçerli bir öğe döndürmelidir; diğer tüm dizinler aralık dışı özel durum oluşturmalıdır. Bir alt koleksiyonu destekleyen ve birden fazla olası alt öğe döndürmek için geçersiz kılan GetVisualChild(Int32) bir öğe türü örneğidir Panel.

içindeki FrameworkElement varsayılan uygulama yalnızca bir görsel alt öğe olarak kabul eder. Sıfır dışında için index geçirilen herhangi bir değer, özel durumun oluşmasına neden olur. Dekoratörler, donatıcılar veya özelleştirilmiş işlemeye sahip öğeler gibi bazı ortak öğeler, uygulamayı (ara temel sınıflardan uygulamanın) geçersiz kılar FrameworkElement . Bazı uygulamalar yine de bir görsel alt öğeyi zorlarken diğerleri koleksiyona izin verir.