RenderSize Property

UIElement.RenderSize Property


Gets (or sets, but see Remarks) the final render size of this element.

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

public Size RenderSize { get; set; }

Property Value

Type: System.Windows.Size

The rendered size for this element.


Do not attempt to set this property, either in XAML or in code, if using the  layout system. Nearly all typical application scenarios will use this layout system. The layout system will not respect sizes set in the RenderSize property directly. The RenderSize property is declared writable only to enable certain bridging cases that deliberately circumvent the typical layout protocols, such as support for the Adorner class.GTMTGTMT

This property can be used for checking the applicable render size within layout system overrides such as OnRender or GetLayoutClip.

A more common scenario is handling the SizeChanged event with the class handler override or the OnRenderSizeChanged event.

The following example shows how a custom adorner uses the RenderSize value in order to create and size the rectangle graphic that defines the adorner, as part of its OnRenderimplementation.

.NET Framework
Available since 3.0
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Return to top
© 2015 Microsoft