UIElement::RenderSize Property

.NET Framework (current version)

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

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

Syntax

public:
property Size RenderSize {
	Size get();
	void set(Size value);
}

Property Value

Type: System.Windows::Size

The rendered size for this element.

Important
Do not attempt to set this property, either in XAML or in code, if using the WPF framework-level 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 WPF core-level bridging cases that deliberately circumvent the typical layout protocols, such as support for the Adorner class.

Do not attempt to set this property, either in XAML or in code, if using the WPF framework-level 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 WPF core-level bridging cases that deliberately circumvent the typical layout protocols, such as support for the Adorner class.

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.

XAML Text Usage

Examples

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.

C++

No code example is currently available or this language may not be supported.

Version Information

.NET Framework
Available since 3.0
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0