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根据父元素的高度和宽度是否由或Height / Width确定MaxHeight / MaxWidth，对布局行为有不同的影响。 MaxHeight / MaxWidth 无论有效剪辑的值如何，始终尊重父元素的 ClipToBounds 元素，并且有效剪辑将始终基于这些最大值剪辑内容。 父级的Height / Width设置不会在内容ClipToBounds时false剪辑内容，但如果是ClipToBounds，则剪辑内容。true

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

InkCanvas、InkPresenter和Popup每个重写默认值。true

FrameworkElement 重写此依赖属性的元数据。 具体而言， FrameworkElement 指定此属性以允许属性值继承（Inherits 在 true 元数据中）。 此上下文中的属性值继承意味着，如果没有其他值通过 ClipToBounds 本地值或样式分配的子元素，则具有此值的最近父元素的值（同样，在样式中，默认值或本地值），则属性系统会将父元素中的值分配给所有未分配的子元素。 在实践中，这意味着可以指定是否允许剪辑到根元素的边界，并且该值将传播到尚未明确分配它 false的所有子元素。

Dependency 属性信息

项目	价值
标识符字段	ClipToBoundsProperty
元数据属性设置为 true	None

另请参阅

• Clip