Window.SizeToContent Window.SizeToContent Window.SizeToContent Window.SizeToContent Property

Определение

Возвращает или задает значение, указывающее, изменится ли автоматически размер окна в соответствии с размером его содержимого.Gets or sets a value that indicates whether a window will automatically size itself to fit the size of its content.

public:
 property System::Windows::SizeToContent SizeToContent { System::Windows::SizeToContent get(); void set(System::Windows::SizeToContent value); };
public System.Windows.SizeToContent SizeToContent { get; set; }
member this.SizeToContent : System.Windows.SizeToContent with get, set
Public Property SizeToContent As SizeToContent

Значение свойства

Значение SizeToContent.A SizeToContent value. Значение по умолчанию — Manual.The default is Manual.

Примеры

В следующем примере показано, SizeToContent как задать свойство в коде, чтобы указать, как размер окна изменяется в соответствии с содержимым.The following example shows how to set the SizeToContent property in code to specify how a window resizes to fit its content.


// Manually alter window height and width
this.SizeToContent = SizeToContent.Manual;

// Automatically resize width relative to content
this.SizeToContent = SizeToContent.Width;

// Automatically resize height relative to content
this.SizeToContent = SizeToContent.Height;

// Automatically resize height and width relative to content
this.SizeToContent = SizeToContent.WidthAndHeight;

' Manually alter window height and width
Me.SizeToContent = SizeToContent.Manual

' Automatically resize width relative to content
Me.SizeToContent = SizeToContent.Width

' Automatically resize height relative to content
Me.SizeToContent = SizeToContent.Height

' Automatically resize height and width relative to content
Me.SizeToContent = SizeToContent.WidthAndHeight

Комментарии

Если SizeToContent параметр имеет WidthAndHeightзначение, установка параметра Height или Width не оказывает никакого влияния; можно задать оба свойства, но значения, которые они задают с помощью, не применяются к окну.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.

Если SizeToContent параметр имеет Heightзначение, значение Height параметра не изменяет высоту окна.When SizeToContent is set to Height, setting Height does not change the height of the window.

Если SizeToContent имеет Width значение, параметр не изменяет ширину окна. WidthWhen SizeToContent is set to Width, setting Width does not change the width of the window.

Если SizeToContent имеет значение, отличное от Manual:If SizeToContent has a value other than Manual:

  • SizeToContentавтоматически устанавливается в Manual значение, если пользователь изменяет размер окна с помощью захвата изменения размера или перетаскивания границы.SizeToContent is automatically set to Manual if a user resizes the window by using the resize grip or dragging the border.

  • Если размер содержимого изменяется так, что приводит к изменению размера окна, SizeChanged возникает исключение.If the size of the content changes in a way that causes the window to resize itself, SizeChanged is raised.

Если окно является прозрачным (см AllowsTransparency. раздел), следует установить SizeToContent для WidthAndHeight параметра значение, чтобы размер окна не превышал его видимого содержимого.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.

Сведения о свойстве зависимостейDependency Property Information

Поле идентификатораIdentifier field SizeToContentProperty
Свойства метаданных, для которых задано значениеtrueMetadata properties set to true НетNone

Применяется к

Дополнительно