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

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 hat ClipToBounds unterschiedliche Auswirkungen auf das Layoutverhalten, je nachdem, ob die Höhe und Breite des übergeordneten Elements durch Height / Width oder MaxHeight / MaxWidthbestimmt werden.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 immer berücksichtigt werden, unabhängig vom Wert ClipToBounds, und durch das effektive abschneiden wird der Inhalt stets 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. Die Height / Width Einstellungen des übergeordneten Elements schneiden den Inhalt nicht aus, wenn ClipToBounds falsewird. wenn ClipToBounds trueist, wird der Inhalt jedoch Ausschneiden.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 Standardverhalten von false das allgemeine Verhalten ist, das in der UIElement-Klasse implementiert ist.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 UIElement abgeleitet ist, die Metadaten der Abhängigkeits Eigenschaft für diese Eigenschaft in dieser Instanz überschreibt, um stattdessen standardmäßig true.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 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 überschreiben den Standardwert, der truewerden soll.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 FrameworkElement diese Eigenschaft festlegt, um die Vererbung von Eigenschafts Werten zuzulassen (Inherits ist in den Metadaten true).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 ohne anderen Wert für ClipToBounds über lokale Werte oder Stile zugewiesen sind, wird der Wert des nächsten übergeordneten Elements, dem dieser Wert zugewiesen ist, (in den Standardwerten wiederum entweder in Stilen) oder ein lokaler Wert), dann wird der Wert des übergeordneten Elements 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 das root-Element begrenzt werden soll, und dass dieser Wert an alle untergeordneten Elemente weitergegeben wird, die ihn nicht ausdrücklich als falsezugewiesen haben.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