Stroke.Clip 方法

项目
11/04/2008

移除 Stroke 对象在给定矩形以外的部分。

命名空间： Microsoft.Ink
程序集： Microsoft.Ink（在 Microsoft.Ink.dll 中）

语法

声明
Public Sub Clip ( _
    r As Rectangle _
)
用法
Dim instance As Stroke
Dim r As Rectangle

instance.Clip(r)

public void Clip(
    Rectangle r
)

public:
void Clip(
    Rectangle r
)

public void Clip(
    Rectangle r
)

public function Clip(
    r : Rectangle
)

参数

r
类型：System.Drawing.Rectangle
在其外部裁剪每个 Stroke 对象的矩形。

备注

r 参数是用墨迹空间坐标指定的。

此方法更新父 Ink 对象。无论何时从 Ink 对象移除墨迹，任何为该 Ink 对象定义的 Stroke 对象或 Strokes 集合都将无效。

调用 Clip 方法后，每个 Stroke 对象的属性都可能发生更改。例如，如果 Stroke 对象在裁剪矩形区域中开始，退出裁剪矩形，然后返回裁剪矩形中；则它将成为两个 Stroke 对象，其中至少一个具有新的 Id 属性。尽管有此行为，即使发生更改，Ink 对象中的所有 Id 属性仍保证是唯一的。Stroke 对象的其他属性也可能发生类似更改。

示例

在此示例中，修改 InkOverlay 的所有选定 Stroke 对象。首先，调用 GetBoundingBox 方法来确定所选 Stroke 的边框。然后，将得到的边框修改为其原始宽度的一半。然后，调用 Clip 方法来裁剪 Stroke 的右半部分。

For Each S As Stroke In mInkOverlay.Selection
    Dim sBounds As Rectangle = S.GetBoundingBox()
    ' decrease width by half
    sBounds.Width -= sBounds.Width / 2
    ' clip the stroke
    S.Clip(sBounds)
Next

foreach (Stroke S in mInkOverlay.Selection)
{
    Rectangle sBounds = S.GetBoundingBox();
    // decrease width by half
    sBounds.Width -= sBounds.Width / 2;
    // clip the stroke
    S.Clip(sBounds);
}