IInkStrokes::Clip 方法 (msinkaut.h)
拿掉矩形外部 的 IInkStrokeDisp 物件或 InkStrokes 集合的部分。
語法
HRESULT Clip(
[in] IInkRectangle *Rectangle
);
參數
[in] Rectangle
指定在外部裁剪筆劃或筆劃的矩形。 矩形是在筆跡空間座標中指定。
傳回值
這個方法可以傳回下列其中一個值。
傳回碼 | 描述 |
---|---|
|
成功。 |
|
參數包含無效的指標。 |
|
InkDisp 對象未註冊。 |
|
無效的裁剪矩形。 |
|
方法內發生例外狀況。 |
|
發生未指定的錯誤。 |
備註
對於 InkDisp 物件,矩形交集的所有筆劃都會在交集點分割。 矩形外的所有筆劃部分都會從 InkDisp 物件中移除。 方法可能會在筆劃與矩形交集的點,將新點新增至筆劃。 在 InkDisp 物件上呼叫 Clip 方法之後,InkDisp 物件筆劃集合中的筆劃標識碼保證是唯一的,但不保證會保留其他資訊。
這個方法不會在裁剪時將畫筆寬度納入考慮。 它只會裁剪實際的筆跡或筆劃數據。
針對 IInkStrokeDisp 物件或 InkStrokes 集合, Clip 方法會更新父 InkDisp 物件。 每當從 InkDisp 物件中移除筆跡時,任何針對 InkDisp 物件定義的 IInkStrokeDisp 物件或 InkStrokes 集合都可能會失效。
如需筆跡數據的詳細資訊,請參閱 筆跡數據。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows XP Tablet PC Edition [僅限傳統型應用程式] |
最低支援的伺服器 | 都不支援 |
目標平台 | Windows |
標頭 | msinkaut.h |
程式庫 | InkObj.dll |