Window.SizeToContent Property (System.Windows)

.NET Framework Class Library

Window..::.SizeToContent Property

Updated: February 2009

Gets or sets a value that indicates 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)
XMLNS for XAML: http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation

Syntax

Visual Basic (Declaration)

Public Property SizeToContent As SizeToContent

Visual Basic (Usage)

Dim instance As Window
Dim value As SizeToContent

value = instance.SizeToContent

instance.SizeToContent = value

public SizeToContent SizeToContent { get; set; }

Visual C++

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

JScript

public function get SizeToContent () : SizeToContent
public function set SizeToContent (value : SizeToContent)

XAML Attribute Usage

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

Property Value

Type: System.Windows..::.SizeToContent
A SizeToContent value. The default is Manual.

Dependency Property Information

Identifier field	SizeToContentProperty
Metadata properties set to true	None

Remarks

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.

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

Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information

.NET Framework

Supported in: 3.5, 3.0

Reference

Window Class

Window Members

System.Windows Namespace

MeasureOverride

ArrangeOverride

ResizeMode

Other Resources

Dependency Properties Overview

Change History

Date	History	Reason
February 2009	Fixed remarks: when SizeToContent is set to Height or Width, setting the corresponding Height or Width property does not change the size of the window.	Content bug fix.

Date

History

Reason

February 2009

Fixed remarks: when SizeToContent is set to Height or Width, setting the corresponding Height or Width property does not change the size of the window.

Content bug fix.