UIElement.ClipToBounds 属性

定义

命名空间:

System.Windows

程序集:

PresentationCore.dll

获取或设置一个值，该值指示是否剪切此元素的内容(或来自此元素的子元素的内容)使其适合包含元素的大小。 这是依赖项属性。

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

属性值

Boolean

如果应剪切内容，则为 true；否则为 false。 默认值是 false。

注解

对于子元素， ClipToBounds 对布局行为的影响不同，具体取决于父元素的高度和宽度是由 还是MaxWidthMaxHeight / 确定Height / Width的。 MaxHeight / MaxWidth 无论 的值 ClipToBounds 如何，始终遵循父元素的 ，并且有效剪辑将始终基于这些最大值剪辑内容。 当 为 时，父项的设置HeightWidth / 不会剪辑内容，但如果 为 true，则剪裁内容ClipToBounds。ClipToBoundsfalse

请注意，默认为 false 是 类中实现的 UIElement 一般行为。 派生自 UIElement 的任何给定元素都可能替代该实例中此属性的依赖属性元数据，改为默认 true 为 。 多个现有派生类替代此元数据和/或调整依赖属性默认值。

InkCanvas、 InkPresenter和 Popup 都替代默认值为 true。

FrameworkElement 重写此依赖属性的元数据。 具体而言， FrameworkElement 指定此属性以允许在元数据) 中 (Inheritstrue 继承属性值。 此上下文中的属性值继承意味着，如果通过本地值或样式分配的子元素没有其他值 ClipToBounds ，则分配了此值的最接近父元素的值再次 (，无论是在样式、默认值还是本地值) ，则属性系统会将父元素中的值分配给所有未分配的子元素。 实际上，这意味着你可以指定是否允许剪辑到根元素的边界，并且该值将传播到尚未专门将其指定为 false的所有子元素。

依赖项属性信息

标识符字段	ClipToBoundsProperty
元数据属性设置为 true	无

另请参阅

• Clip