UIElement.ClipToBounds Eigenschaft

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

Boolean

true, wenn der Inhalt abgeschnitten werden soll, andernfalls false.true if the content should be clipped; otherwise, false. Der Standardwert ist false.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 Elements durch oder bestimmt werden Height / Width 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 das übergeordnete Element wird unabhängig vom Wert von immer berücksichtigt, ClipToBounds 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 die Einstellungen des übergeordneten Elements Height / Width wird der Inhalt nicht zugeschnitten, wenn den Wert ClipToBounds false hat. der Inhalt wird jedoch Clip, wenn gleich 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 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, das von abgeleitet wird, UIElement die Metadaten der Abhängigkeits Eigenschaft für diese Eigenschaft in dieser Instanz überschreibt, sodass stattdessen der Standardwert von trueIt 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, InkPresenter und Popup überschreiben den Standardwert true .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 FrameworkElement Diese Eigenschaft fest, um die Vererbung von Eigenschafts Werten zuzulassen ( Inherits true in Metadaten).Specifically, FrameworkElement designates this property to allow property value inheritance (Inherits is true in metadata). Die Vererbung von Eigenschafts Werten in diesem Kontext bedeutet Folgendes: Wenn untergeordnete Elemente vorhanden sind, für die kein anderer Wert ClipToBounds über lokale Werte oder Stile zugewiesen ist, wird der Wert des nächsten übergeordneten Elements, dem dieser Wert zugewiesen ist (wiederum entweder in Stilen, Standardwerten oder einem lokalen Wert), dem-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, die nicht explizit als zugewiesen wurden 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

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

Gilt für:

Weitere Informationen