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

Definition

Ruft einen Wert ab, der angibt, ob die Größe eines Fensters automatisch an die Größe des entsprechenden Inhalts angepasst werden soll, oder legt diesen fest.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

Eigenschaftswert

Ein SizeToContent-Wert.A SizeToContent value. Die Standardeinstellung ist Manual.The default is Manual.

Beispiele

Im folgenden Beispiel wird gezeigt, wie die SizeToContent -Eigenschaft im Code festgelegt wird, um anzugeben, wie die Größe eines Fensters an seinen Inhalt angepasst wird.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

Hinweise

Wenn SizeToContent Height Width auf WidthAndHeightfestgelegt ist, hat das Festlegen von entweder oder keine Auswirkung; beide Eigenschaften können festgelegt werden, aber die Werte, mit denen Sie festgelegt werden, werden nicht auf das Fenster angewendet.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.

Wenn SizeToContent Height auf Heightfestgelegt ist, wird durch die-Einstellung die Höhe des Fensters nicht geändert.When SizeToContent is set to Height, setting Height does not change the height of the window.

Wenn SizeToContent Width auf Widthfestgelegt ist, wird durch die-Einstellung nicht die Breite des Fensters geändert.When SizeToContent is set to Width, setting Width does not change the width of the window.

Wenn SizeToContent einen anderen Wert als Manualhat:If SizeToContent has a value other than Manual:

  • SizeToContentwird automatisch auf fest Manual gelegt, wenn ein Benutzer die Größe des Fensters mithilfe des Zieh Punkts zur Größenänderung oder ziehen des Rahmens ändert.SizeToContent is automatically set to Manual if a user resizes the window by using the resize grip or dragging the border.

  • Wenn sich die Größe des Inhalts auf eine Weise ändert, die bewirkt, dass die Größe des Fensters SizeChanged geändert wird, wird ausgelöst.If the size of the content changes in a way that causes the window to resize itself, SizeChanged is raised.

Wenn ein Fenster transparent ist (siehe AllowsTransparency), sollten Sie die Einstellung SizeToContent auf WidthAndHeight festlegen, um sicherzustellen, dass das Fenster nicht größer als der sichtbare Inhalt ist.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.

Hinweis

Sie können diese Eigenschaft nicht festlegen oder erhalten, wenn ein Fenster in einem Browser gehostet wird.You cannot set or get this property when a window is hosted in a browser.

Informationen zur AbhängigkeitseigenschaftDependency Property Information

BezeichnerfeldIdentifier field SizeToContentProperty
Metadateneigenschaften auf true festgelegtMetadata properties set to true KeineNone

Gilt für:

Siehe auch