UIElement.ClipToBounds UIElement.ClipToBounds UIElement.ClipToBounds UIElement.ClipToBounds Property

Definition

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.Gets or sets a value indicating whether to clip the content of this element (or content coming from the child elements of this element) to fit into the size of the containing element. Hierbei handelt es sich um eine Abhängigkeitseigenschaft.This is a dependency property.

public:
 property bool ClipToBounds { bool get(); void set(bool value); };
public bool ClipToBounds { get; set; }
member this.ClipToBounds : bool with get, set
Public Property ClipToBounds As Boolean

Eigenschaftswert

true, wenn der Inhalt abgeschnitten werden soll, andernfalls false.true if the content should be clipped; otherwise, false. Der Standardwert ist falsesein.The default value is false.

Hinweise

Bei untergeordneten Elementen ClipToBounds wirkt sich dies auf das Layoutverhalten aus, abhängig davon, ob die Höhe und Breite des übergeordneten Height Elements MaxHeight durch / Width oder / bestimmtwerden MaxWidth.For child elements, ClipToBounds has different effects on layout behaviors depending on whether the height and width of the parent element are being determined by Height / Width or MaxHeight / MaxWidth. MaxHeight / MaxWidthdas übergeordnete Element wird unabhängig vom Wert von ClipToBounds immer berücksichtigt, und beim effektiven Clipping wird der Inhalt immer auf der Grundlage dieser Maximums abgeschnitten.MaxHeight / MaxWidth of the parent element are always respected regardless of the value of ClipToBounds and the effective clipping will always clip the content based on these maximums. Durch Height die Width / true ClipToBounds EinstellungendesClipToBounds übergeordneten Elements wird der Inhalt nicht zugeschnitten ,wenndenWerthat.derInhaltwirdjedochClip,wenngleichist.falseThe parent's Height / Width settings will not clip the content when ClipToBounds is false, but will clip the content if ClipToBounds is true.

Beachten Sie, dass das Standard false Verhalten von als Standardverhalten in der UIElement -Klasse implementiert wird.Note that defaulting to false is the general behavior as implemented in the UIElement class. Es ist möglich, dass ein beliebiges Element, UIElement das von abgeleitet wird, die Metadaten der Abhängigkeits Eigenschaft für diese Eigenschaft in true dieser Instanz überschreibt, sodass stattdessen der Standardwert vonIt is possible for any given element that derives from UIElement to override the dependency property metadata for this property in that instance to default to true instead. Mehrere vorhandene abgeleitete Klassen überschreiben diese Metadaten und/oder passen den Standardwert der Abhängigkeits Eigenschaft an.Several existing derived classes override this metadata and/or adjust the dependency property default value.

InkCanvas, InkPresenterund Popup über schreibentrueden Standardwert.InkCanvas, InkPresenter, and Popup each override the default value to be true.

FrameworkElementüberschreibt die Metadaten für diese Abhängigkeits Eigenschaft.FrameworkElement overrides the metadata for this dependency property. Insbesondere legt diese Eigenschaft fest, um die Vererbung von Eigenschafts true Werten zuzulassen (Inherits in Metadaten). FrameworkElementSpecifically, FrameworkElement designates this property to allow property value inheritance (Inherits is true in metadata). Die Vererbung von Eigenschafts Werten in diesem Kontext bedeutet, dass, wenn untergeordnete Elemente ClipToBounds vorhanden sind, für die kein anderer Wert durch lokale Werte oder Stile zugewiesen ist, der Wert des nächsten übergeordneten Elements mit diesem Wert zugewiesen wird (in Standardeinstellung wiederum entweder in Stilen). -Werte oder ein lokaler Wert), dann wird der Wert aus dem übergeordneten-Element allen nicht zugewiesenen untergeordneten Elementen vom-Eigenschaften System zugewiesen.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 der Praxis bedeutet dies, dass Sie angeben können, ob Clip an die Grenzen des Stamm Elements zulässig sein soll, und dass dieser Wert an alle untergeordneten Elemente weitergegeben wird false, die nicht explizit als zugewiesen wurden.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.

Informationen zur AbhängigkeitseigenschaftDependency Property Information

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

Gilt für:

Siehe auch