Strokes.Clip メソッド

[アーティクル]
10/28/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 オブジェクトがクリッピング四角形の領域内から開始してクリッピング四角形の外側に出た後、クリッピング四角形内に戻る場合、このオブジェクトは 2 つの Stroke オブジェクトになり、少なくとも 1 つのオブジェクトが新しい Id プロパティを持ちます。この動作にかかわらず、すべての Id プロパティは、プロパティが変わった場合であっても Ink オブジェクト内で必ず一意になります。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);
}