Stroke.Clip 方法

發行項
10/29/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);
}