IInkDisp：：Clip 方法 (msinkaut.h)

拿掉矩形外部 的 IInkStrokeDisp 物件或 InkStrokes 集合的部分。

語法

HRESULT Clip(
  [in] IInkRectangle *Rectangle
);

參數

[in] Rectangle

指定在外部裁剪筆劃或筆劃的矩形。 矩形是在筆跡空間座標中指定。

傳回值

這個方法可以傳回下列其中一個值。

傳回碼	描述
S_OK	成功。
E_POINTER	參數包含無效的指標。
REGDB_CLASSNOTREG	InkDisp 對象未註冊。
E_INVALIDARG	無效的裁剪矩形。
E_INK_EXCEPTION	方法內發生例外狀況。
E_FAIL	發生未指定的錯誤。

備註

對於 InkDisp 物件，矩形交集的所有筆劃都會在交集點分割。 矩形外的所有筆劃部分都會從 InkDisp 物件中移除。 方法可能會在筆劃與矩形交集的點，將新點新增至筆劃。 在 InkDisp 物件上呼叫 Clip 方法之後，InkDisp 物件筆劃集合中的筆劃標識碼保證是唯一的，但不保證會保留其他資訊。

這個方法不會在裁剪時將畫筆寬度納入考慮。 它只會裁剪實際的 筆跡 或筆劃數據。

針對 IInkStrokeDisp 物件或 InkStrokes 集合， Clip 方法會更新父 InkDisp 物件。 每當從 InkDisp 物件中移除筆跡時，任何針對 InkDisp 物件定義的 IInkStrokeDisp 物件或 InkStrokes 集合都可能會失效。

如需筆跡數據的詳細資訊，請參閱 筆跡數據。

規格需求

需求	值
最低支援的用戶端	Windows XP Tablet PC Edition [僅限傳統型應用程式]
最低支援的伺服器	都不支援
目標平台	Windows
標頭	msinkaut.h
程式庫	InkObj.dll

另請參閱

HitTest (Rectangle、Single) 方法

IInkDisp

InkDisp 類別

InkRectangle 類別