This documentation is archived and is not being maintained.

Window.SizeToContent Property

Gets or sets a value that specifies whether a window will automatically size itself to fit the size of its content. This is a dependency property.

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

Public Property SizeToContent As SizeToContent
Dim instance As Window
Dim value As SizeToContent

value = instance.SizeToContent

instance.SizeToContent = value
/** @property */
public SizeToContent get_SizeToContent ()

/** @property */
public void set_SizeToContent (SizeToContent value)

public function get SizeToContent () : SizeToContent

public function set SizeToContent (value : SizeToContent)

<object SizeToContent="SizeToContent" .../>

Property Value

A SizeToContent value. The default value is Manual.

Identifier Field


Metadata properties set to true


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 will change the height of the window.

When SizeToContent is set to Width, setting Width will 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.

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0