Window::SizeToContent Property


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Gets or sets a value that indicates whether a window will automatically size itself to fit the size of its content.

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

property SizeToContent SizeToContent {
	SizeToContent get();
	void set(SizeToContent value);

Property Value

Type: System.Windows::SizeToContent

A SizeToContent value. The default is Manual.

When SizeToContent is set to WidthAndHeight, setting either Height or Width has no effect; both properties can be set, but the values they are set with are not applied to the window.

When SizeToContent is set to Height, setting Height does not change the height of the window.

When SizeToContent is set to Width, setting Width does not change the width of the window.

If SizeToContent has a value other than Manual:

  • SizeToContent is automatically set to Manual if a user resizes the window by using the resize grip or dragging the border.

  • If the size of the content changes in a way that causes the window to resize itself, SizeChanged is raised.

If a window is transparent (see AllowsTransparency), you should consider setting SizeToContent to WidthAndHeight to ensure the window is no larger than its visible content.


You cannot set or get this property when a window is hosted in a browser.

Identifier field


Metadata properties set to true


The following example shows how to set the SizeToContent property in code to specify how a window resizes to fit its content.

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

.NET Framework
Available since 3.0
Return to top