Strokes.Clip 方法

發行項
10/29/2008

從 Strokes 集合中移除每個 Stroke 物件超出指定矩形的部分。

命名空間： Microsoft.Ink
組件： Microsoft.Ink (在 Microsoft.Ink.dll 中)

語法

'宣告
Public Sub Clip ( _
    r As Rectangle _
)
'用途
Dim instance As Strokes
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

備註

R 參數是以筆墨空間座標指定。

這個方法會更新父代 Ink 物件。只要從 Ink 物件中移除筆墨，針對該 Ink 物件定義的任何 Stroke 物件或 Strokes 集合可能都會變成無效。

在您呼叫 Clip 方法之後，各個 Stroke 物件的屬性可能會變更。例如，Stroke 物件從裁剪矩形區域中開始，離開裁剪矩形，然後返回裁剪矩形，則它會變成兩個 Stroke 物件，而且至少其中一個物件有新的 Id 屬性。除了這個行為之外，Ink 物件中的所有 Id 屬性即使經過變更，也一定會是唯一屬性。Stroke 物件的其他屬性也可能會進行類似變更。

範例

在這個範例中，會將 InkOverlay 物件的 Strokes 集合裁剪為 Strokes 集合的右半部。首先會藉由呼叫 GetBoundingBox 方法，取得 Strokes 集合的週框。接著會建立已裁剪右半部的新矩形，並將它傳遞至 Clip 方法。

' Access to the Strokes property returns a copy of the Strokes object.
' This copy must be implicitly (via using statement) or explicitly
' disposed of in order to avoid a memory leak.
Using allStrokes As Strokes = mInkOverlay.Ink.Strokes
    ' Determine the bounding box for the Strokes collection.
    Dim bounds As Rectangle = allStrokes.GetBoundingBox()
    'Create rectangle for Clip method.
    Dim halfRectangle As Rectangle = _
            New Rectangle(bounds.Left, bounds.Top, bounds.Width / 2, bounds.Height)
    ' Clip the Strokes collection.
    allStrokes.Clip(halfRectangle)
End Using

// Access to the Strokes property returns a copy of the Strokes object.
// This copy must be implicitly (via using statement) or explicitly
// disposed of in order to avoid a memory leak.
using (Strokes allStrokes = mInkOverlay.Ink.Strokes)
{
    // Determine the bounding box for the Strokes collection.
    Rectangle bounds = allStrokes.GetBoundingBox();
    //Create rectangle for Clip method.
    Rectangle halfRectangle = 
        new Rectangle(bounds.Left, bounds.Top, bounds.Width / 2, bounds.Height);
    // Clip the Strokes collection.
    allStrokes.Clip(halfRectangle);
}