Adorner Class (System.Windows.Documents)

Adorner Class
This page is specific to:.NET Framework Version:3.03.54.0

.NET Framework Class Library

Adorner Class

Abstract class that represents a FrameworkElement that decorates a UIElement.

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

Syntax

C++

JScript

Copy to Clipboard Print

'Usage

Dim instance As Adorner

'Declaration

Public MustInherit Class Adorner _
    Inherits FrameworkElement

XAML

This class is abstract; see Inheritance Hierarchy 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 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information