Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

UIElement.ClipToBounds-Eigenschaft

 

Veröffentlicht: Oktober 2016

Ruft einen Wert ab bzw. legt einen Wert fest, der angibt, ob der Inhalt dieses Elements (oder Inhalt aus seinen untergeordneten Elementen) abgeschnitten wird, sodass er in das enthaltende Element passt. Hierbei handelt es sich um eine Abhängigkeitseigenschaft.

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

public bool ClipToBounds { get; set; }

Eigenschaftswert

Type: System.Boolean

true, wenn der Inhalt abgeschnitten werden soll, andernfalls false. Der Standardwert ist false.

For child elements, P:System.Windows.UIElement.ClipToBounds has different effects on layout behaviors depending on whether the height and width of the parent element are being determined by P:System.Windows.FrameworkElement.Height / P:System.Windows.FrameworkElement.Width or P:System.Windows.FrameworkElement.MaxHeight / P:System.Windows.FrameworkElement.MaxWidth. P:System.Windows.FrameworkElement.MaxHeight / P:System.Windows.FrameworkElement.MaxWidth of the parent element are always respected regardless of the value of P:System.Windows.UIElement.ClipToBounds and the effective clipping will always clip the content based on these maximums. The parent's P:System.Windows.FrameworkElement.Height / P:System.Windows.FrameworkElement.Width settings will not clip the content when P:System.Windows.UIElement.ClipToBounds is false, but will clip the content if P:System.Windows.UIElement.ClipToBounds is true.

Note that defaulting to false is the general behavior as implemented in the T:System.Windows.UIElement class. It is possible for any given element that derives from T:System.Windows.UIElement to override the dependency property metadata for this property in that instance to default to true instead. Several existing derived classes override this metadata and/or adjust the dependency property default value.

InkCanvas, InkPresenter, and Popup each override the default value to be true.

FrameworkElement overrides the metadata for this dependency property. Specifically, FrameworkElement designates this property to allow property value inheritance (Inherits is true in metadata). Property value inheritance in this context means that if there are child elements with no other value for ClipToBounds assigned through local values or styles, the value of the nearest parent element with this value assigned (again, either in styles, by default values, or a locally value), then the value from the parent element will be assigned to all unassigned child elements by the property system. In practice this means that you can specify whether to allow clip to bounds at the root element, and that value will propagate to all child elements that have not specifically assigned it as false.

Identifier field

ClipToBoundsProperty

Metadata properties set to true

None

.NET Framework
Verfügbar seit 3.0
Zurück zum Anfang
Anzeigen: