DrawElement Method (UIElement)

Renders the element into the graphics object of the specified defaultDrawParams. This method will recursively invoke itself for rendering the descendant elements.

Syntax

Visual Basic

'Declaration
 
Public Sub DrawElement( _
   ByRef defaultDrawParams As UIElementDrawParams _
) 

C#

public void DrawElement( 
   ref UIElementDrawParams defaultDrawParams
)

Parameters

defaultDrawParams

UIElementDrawParams structure used as the default values for rendering the element.

Remarks

Normally, rendering of the the element is done using the various Draw(Graphics,Rectangle,Boolean,AlphaBlendMode) method overloads. However, when performing lots of separate draw operations of different elements within the same control at the same time, this method is will provide better performance then invoking the Draw(Graphics,Rectangle,Boolean,AlphaBlendMode) method multiple times.

Note: It is up to the caller to manage the lifetime of the DrawCache for which the defaultDrawParams is created.

Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Server 2012, Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2