IInkStrokeDisp：：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) 方法

IInkStrokeDisp 介面

InkRectangle 類別