Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

FrameworkElement.GetVisualChild-Methode: (Int32)

 

Veröffentlicht: Oktober 2016

Überschreibt Visual.GetVisualChild, und ein untergeordnetes Element am angegebenen Index aus einer Auflistung von untergeordneten Elementen zurückgegeben.

Namespace:   System.Windows
Assembly:  PresentationFramework (in PresentationFramework.dll)

protected override Visual GetVisualChild(
	int index
)

Parameter

index
Type: System.Int32

Der nullbasierte Index des angeforderten untergeordneten Elements in der Auflistung.

Rückgabewert

Type: System.Windows.Media.Visual

Das angeforderte untergeordnete Element. Es sollte nicht null zurückgeben; wenn der angegebene Index außerhalb des Bereichs liegt, wird eine Ausnahme ausgelöst.

In der FrameworkElement Implementierung der einzige gültige Index 0 (null) ist. Das Inhaltsmodell für GetVisualChild unterstützt entweder NULL oder ein untergeordnetes Element, aber keine Auflistung.

Hinweise für Vererber:

Diese Implementierung gilt nur für Elemente, die keine besser beschreibende Auflistung visueller untergeordneter Elemente verwalten. Jedes Element, das eine solche Auflistung verfügt muss diese Methode überschreiben, und ordnen Sie den Index einem äquivalenten Index in der Auflistung der untergeordneten Elemente, die von diesem Element unterstützt wird. Ein Index im Bereich von 0 bis VisualChildrenCount (minus eins) sollte ein gültiges Element; zurückgeben alle anderen Indizes sollten Ausnahme außerhalb des gültigen Bereichs. Ein Beispiel für einen Elementtyp, der eine untergeordnete Auflistung unterstützt und überschreibt GetVisualChild mehrere mögliche untergeordnete Elemente zurückgegeben werden Panel.

Die standardmäßige Implementierung in FrameworkElement wird nur eine visuelle untergeordnete vorausgesetzt. Jeder Wert für die index als NULL festgelegt, wird eine Ausnahme ausgelöst wird. Mehrere gemeinsame Elemente, z. B. Decorators, Adorner oder Elemente mit spezialisierten Renderern, überschreiben die FrameworkElement -Implementierung (der Implementierung aus Zwischenbasisklassen). Einige Implementierungen erzwingen noch eine visuelle untergeordnete, während eine andere gestattet.

Im folgenden Beispiel wird veranschaulicht, wie ein benutzerdefinierter Adorner die Werte, die deklariert, indem eine VisualCollection die er für seine mehreren visuellen untergeordneten Elemente beibehält. Diese Werte werden gemeldet, durch Überschreiben von VisualChildrenCount und GetVisualChild.

// To store and manage the adorner's visual children.
VisualCollection visualChildren;
// 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]; }

.NET Framework
Verfügbar seit 3.0
Zurück zum Anfang
Anzeigen: