Adorner Class (System.Windows.Documents)

Switch on low bandwidth view

Collapse All

Language Filter

This page is specific to

.NET Framework 3.0

Other versions are also available for the following:

Adorner Class

Abstract class that represents a FrameworkElement that decorates a UIElement.

Namespace: System.Windows.Documents
Assembly: PresentationFramework (in presentationframework.dll)
XML Namespace: http://schemas.microsoft.com/winfx/2006/xaml/presentation

Syntax

Visual Basic (Declaration)

Public MustInherit Class Adorner
    Inherits FrameworkElement

Visual Basic (Usage)

Dim instance As Adorner

public abstract class Adorner : FrameworkElement

C++

public ref class Adorner abstract : public FrameworkElement

public abstract class Adorner extends FrameworkElement

JScript

public abstract class Adorner extends FrameworkElement

XAML

This class is abstract; see <a href="#inheritanceHierarchyToggle">Inheritance Hierarchy</a> for derived non-abstract classes usable in XAML.

Remarks

An adorner is a custom FrameworkElement that is bound to a UIElement. Adorners are rendered in an adorner layer, which is a rendering surface that is always on top of the adorned element or a collection of adorned elements; rendering of an adorner is independent from rendering of the UIElement that the adorner is bound to. An adorner is typically positioned relative to the element to which it is bound, using the standard 2-D coordinate origin located at the upper-left of the adorned element.

Note:
The parent of an Adorner is the AdornerLayer that renders the Adorner, not the element being adorned.

Note:
Anything placed in the adorner layer is rendered on top of the rest of any styles you have set. In other words, adorners are always visually on top and cannot be overridden using z-order.

Inheritance Hierarchy

System.Object
   System.Windows.Threading.DispatcherObject
     System.Windows.DependencyObject
       System.Windows.Media.Visual
         System.Windows.UIElement
           System.Windows.FrameworkElement
            System.Windows.Documents.Adorner

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

Version Information

.NET Framework

Supported in: 3.0

Reference

Adorner Members
System.Windows.Documents Namespace
AdornerDecorator
AdornerLayer

Other Resources

Adorners Overview
Implement an Adorner
Bind an Adorner to an Element
Adorn the Children of a Panel
Remove an Adorner from an Element
Remove all Adorners from an Element
SimpleCircleAdorner Sample
ResizingAdorner Sample
Add and Remove Adorners Sample