Diese Dokumentation wurde archiviert und wird nicht länger gepflegt.

AdornerLayer.GetAdornerLayer-Methode

Aktualisiert: November 2007

Gibt die erste Adornerebene in der visuellen Struktur über einem angegebenen Visual zurück.

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

public static AdornerLayer GetAdornerLayer(
	Visual visual
)
public static AdornerLayer GetAdornerLayer(
	Visual visual
)
public static function GetAdornerLayer(
	visual : Visual
) : AdornerLayer
Sie können diese Methoden nicht in XAML verwenden.

Parameter

visual
Typ: System.Windows.Media.Visual
Das visuelle Element, für das eine Adornerebene gesucht werden soll.

Rückgabewert

Typ: System.Windows.Documents.AdornerLayer
Eine Adornerebene für das angegebene visuelle Objekt oder NULL, wenn keine Adornerebene gefunden werden kann.

AusnahmeBedingung
ArgumentNullException

Wird ausgelöst wenn visual den Wert NULL aufweist.

Diese static-Methode durchläuft die visuelle Struktur am angegebenen Visual nach oben und gibt die erste gefundene Adornerebene zurück.

In diesem Beispiel wird gezeigt, wie ein Adorner programmgesteuert an ein angegebenes UIElement gebunden wird.

Um einen Adorner an ein bestimmtes UIElement zu binden, führen Sie die folgenden Schritte aus:

 

  1. Rufen Sie die static-Methode GetAdornerLayer auf, um ein AdornerLayer-Objekt für das zu verzierende UIElement abzurufen. GetAdornerLayer durchläuft, beginnend am angegebenen UIElement, die visuelle Struktur und gibt die erste gefundene Adornerebene zurück. (Wenn keine Adornerebenen gefunden werden, gibt die Methode NULL zurück.)

  2. Rufen Sie die Add-Methode auf, um den Adorner an das Ziel-UIElement zu binden.

Im folgenden Beispiel wird ein SimpleCircleAdorner (siehe weiter oben) an ein TextBox mit dem Namen myTextBox gebunden.

myAdornerLayer = AdornerLayer.GetAdornerLayer(myTextBox);
myAdornerLayer.Add(new SimpleCircleAdorner(myTextBox));


ms521740.alert_note(de-de,VS.90).gifHinweis:

Die Verwendung von Extensible Application Markup Language (XAML) zum Binden eines Adorners an ein anderes Element wird derzeit nicht unterstützt.

Windows Vista

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

.NET Framework

Unterstützt in: 3.5, 3.0
Anzeigen: