UIElement.Clip 属性

定义

获取或设置用于定义 UIElement 内容的大纲的 RectangleGeometry

public:
 property RectangleGeometry ^ Clip { RectangleGeometry ^ get(); void set(RectangleGeometry ^ value); };
RectangleGeometry Clip();

void Clip(RectangleGeometry value);
public RectangleGeometry Clip { get; set; }
var rectangleGeometry = uIElement.clip;
uIElement.clip = rectangleGeometry;
Public Property Clip As RectangleGeometry
<uiElement>
  <uiElement.Clip>
    rectangleGeometry
  </uiElement.Clip>
</uiElement>

属性值

用于剪裁区域大小的矩形几何图形。 默认值为 null (无剪裁) 。

示例

此示例是简单的 XAML 标记,它使用内联 RectangleGeometry 指定剪辑,该内联 矩形Geometry 通过属性语法指定其尺寸。

<Canvas>
    <Image Source="Images/Water_lilies.jpg" Width="200" Height="150">
        <Image.Clip>
            <RectangleGeometry Rect="100 75 50 50"/>
        </Image.Clip>
    </Image>
</Canvas>

注解

Windows 运行时 API 中 为 的UIElement.Clip剪裁几何图形必须是 RectangleGeometry。 不能指定非矩形几何图形。

剪裁的区域是几何图形 的外部 区域。 换句话说, (未剪裁) 显示的内容是使用 Fill 绘制的矩形区域(如果几何图形用作 路径 的数据,而不是剪裁)。 裁剪区域是位于矩形之外的任何区域。 剪裁的区域不可命中测试。

适用于