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

Für untergeordnete Elemente ClipToBounds hat verschiedene Auswirkungen auf die Layoutverhalten, je nachdem, ob die Höhe und Breite des übergeordneten Elements hängen vom wird Height / Width oder MaxHeight / 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 / MaxWidth des übergeordneten Elements werden immer berücksichtigt, unabhängig vom Wert der ClipToBounds und die effektive wird immer den Inhalt basierend auf diese Maximalwerte.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. Des übergeordneten Elements Height / Width Einstellungen werden den Inhalt nicht beschnitten beim ClipToBounds ist false, jedoch werden die Inhalte bei beschneiden ClipToBounds ist true.The 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 der Standardwert false ist das allgemeine Verhalten, da es sich bei Implementierung in der UIElement Klasse.Note that defaulting to false is the general behavior as implemented in the UIElement class. Es ist möglich, dass alle angegebenen Elemente, die abgeleitet UIElement auf die Metadaten von Abhängigkeitseigenschaften für diese Eigenschaft in dieser Instanz aus, um den Standardwert zu überschreiben true stattdessen.It 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 bzw. Anpassen der Standardwert der Abhängigkeitseigenschaft.Several existing derived classes override this metadata and/or adjust the dependency property default value.

InkCanvas, InkPresenter, und Popup jeweils den Standardwert zurück, werden außer Kraft setzen true.InkCanvas, InkPresenter, and Popup each override the default value to be true.

FrameworkElement überschreibt die Metadaten für diese Abhängigkeitseigenschaft.FrameworkElement overrides the metadata for this dependency property. Insbesondere FrameworkElement bestimmt diese Eigenschaft, um die Vererbung von Eigenschaftswerten zu ermöglichen (Inherits ist true in den Metadaten).Specifically, FrameworkElement designates this property to allow property value inheritance (Inherits is true in metadata). Die Vererbung von Eigenschaftswerten in diesem Kontext bedeutet, dass, wenn es untergeordnete Elemente kein anderer Wert für ClipToBounds über lokale Werte oder Stile, den Wert des nächsten übergeordneten Element mit diesem Wert zugewiesen (in diesem Fall entweder in Stilen, in der Standardeinstellung zugewiesen Werte, oder einen lokalen Wert), und klicken Sie dann der Wert aus dem übergeordneten Element für alle nicht zugewiesenen untergeordneten Elemente vom Eigenschaftensystem zugewiesen werden soll.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 können angeben, ob der Clip Grenzen im Stammelement darf, und die Wert für alle untergeordneten Elemente propagiert werden, die nicht explizit als zugewiesen false.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

Feld "ID"Identifier field ClipToBoundsProperty
Legen Sie auf der Metadaten-Eigenschaften trueMetadata properties set to true KeinerNone

Gilt für:

Siehe auch