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

Definición

Obtiene o establece un valor que indica si hay que recortar el contenido de este elemento (o el contenido de los elementos secundarios de este elemento) para que se ajuste al tamaño del elemento contenedor.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. Es una propiedad de dependencia.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

Valor de propiedad

true si debe recortarse el contenido; de lo contrario, false.true if the content should be clipped; otherwise, false. El valor predeterminado es false.The default value is false.

Comentarios

Para los elementos secundarios, ClipToBounds tiene efectos diferentes en los comportamientos de diseño dependiendo de si se está determinando el alto y ancho del elemento primario por Height / Width o 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 del elemento primario siempre se respetan independientemente del valor de ClipToBounds y el recorte efectivo siempre recorta el contenido basándose en estos valores máximos.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. Del elemento primario Height / Width configuración no recorta el contenido cuando ClipToBounds es false, pero se recorta el contenido if ClipToBounds es 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.

Tenga en cuenta que el valor predeterminado false es el comportamiento general tal como está implementado en el UIElement clase.Note that defaulting to false is the general behavior as implemented in the UIElement class. Es posible que cualquier elemento que se derive de UIElement para invalidar los metadatos de propiedad de dependencia para esta propiedad en esa instancia de forma predeterminada, true en su lugar.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. Varias clases derivadas existentes ajustan el valor predeterminado de propiedad de dependencia o de invalidación de metadatos.Several existing derived classes override this metadata and/or adjust the dependency property default value.

InkCanvas, InkPresenter, y Popup cada invalidar el valor predeterminado sea true.InkCanvas, InkPresenter, and Popup each override the default value to be true.

FrameworkElement invalida los metadatos de esta propiedad de dependencia.FrameworkElement overrides the metadata for this dependency property. En concreto, FrameworkElement designa esta propiedad para permitir la herencia de valores de propiedad (Inherits es true en los metadatos).Specifically, FrameworkElement designates this property to allow property value inheritance (Inherits is true in metadata). Herencia de valores de propiedad en este contexto significa que si hay elementos secundarios con ningún otro valor para ClipToBounds asignado a través de los valores locales o los estilos, el valor del elemento primario más cercano con asignado este valor (de nuevo, ya sea en estilos, de forma predeterminada los valores, o un valor localmente), a continuación, se asignará el valor del elemento primario para todos los elementos secundarios no asignados por el sistema de propiedades.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. En la práctica esto significa que puede especificar si desea permitir recortes en los límites en el elemento raíz, y que el valor se propagará a todos los elementos secundarios que tengan específicamente no lo ha asignado como 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.

Información sobre propiedades de dependenciaDependency Property Information

Campo de identificadorIdentifier field ClipToBoundsProperty
Establecen las propiedades de metadatos en trueMetadata properties set to true NoneNone

Se aplica a

Consulte también: