UIElement.Clip 属性

定义

命名空间:

Microsoft.UI.Xaml

获取或设置用于定义 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>

属性值

RectangleGeometry

用于剪裁区域大小的矩形几何图形。 默认值为 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 绘制的矩形区域（如果几何图形用作 路径 的数据，而不是剪裁）。 裁剪区域是位于矩形之外的任何区域。 剪裁的区域不可命中测试。