UIElement.ClipToBounds Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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. Es una propiedad de dependencia.
public:
property bool ClipToBounds { bool get(); void set(bool value); };public bool ClipToBounds { get; set; }member this.ClipToBounds : bool with get, setPublic Property ClipToBounds As BooleanValor de propiedad
true si debe recortarse el contenido; de lo contrario, false. El valor predeterminado es false.
Comentarios
En el caso de los elementos secundarios, ClipToBounds tiene diferentes efectos en los comportamientos de diseño en función de si el alto y el ancho del elemento primario se determinan medianteWidth / Height o .MaxHeight / MaxWidth MaxHeight / MaxWidth del elemento primario siempre se respetan independientemente del valor de ClipToBounds y el recorte efectivo siempre recortará el contenido en función de estos máximos. La configuración del Height / Width elemento primario no recortará el contenido cuando ClipToBounds sea false, pero recortará el contenido si ClipToBounds es true.
Tenga en cuenta que el false valor predeterminado es el comportamiento general que se implementa en la UIElement clase . Es posible que cualquier elemento determinado que derive de invalide los metadatos de la propiedad de UIElement dependencia para esta propiedad de esa instancia a true en su lugar. Varias clases derivadas existentes invalidan estos metadatos o ajustan el valor predeterminado de la propiedad de dependencia.
InkCanvas, InkPresentery cada uno Popup invalida el valor predeterminado para que sea true.
FrameworkElement invalida los metadatos de esta propiedad de dependencia. En concreto, FrameworkElement designa esta propiedad para permitir la herencia de valores de propiedad (Inherits está true en metadatos). La herencia de valores de propiedad en este contexto significa que si hay elementos secundarios sin ningún otro valor para ClipToBounds asignado a través de estilos o valores locales, el valor del elemento primario más cercano con este valor asignado (de nuevo, en estilos, de forma predeterminada o un valor local), el valor del elemento primario se asignará a todos los elementos secundarios sin asignar por el sistema de propiedades. En la práctica, esto significa que puede especificar si se permite que el clip se delimite en el elemento raíz y ese valor se propagará a todos los elementos secundarios que no lo hayan asignado específicamente como false.
Información sobre propiedades de dependencia
| Campo identificador | ClipToBoundsProperty |
Propiedades de metadatos establecidas en true |
None |