共用方式為


IInkDisp::ExtractWithRectangle 方法 (msinkaut.h)

使用已知的矩形來判斷要擷取的筆劃,從現有的 InkDisp 物件剪下或複製筆劃,並貼到新的 InkDisp 物件中。

語法

HRESULT ExtractWithRectangle(
  [in]           IInkRectangle   *Rectangle,
  [in, optional] InkExtractFlags extractFlags,
  [out, retval]  IInkDisp        **ExtractedInk
);

參數

[in] Rectangle

指定要從 InkDisp 物件擷取之筆跡的 InkRectangle 物件。

[in, optional] extractFlags

選擇性。 指定 InkExtractFlags 列舉型別,這個類型會決定應該從現有的 InkDisp 物件剪下或複製筆跡。 默認值為IEF_DEFAULT,這會從現有的 InkDisp 物件剪下筆劃。

[out, retval] ExtractedInk

當這個方法傳回時,會包含 InkDisp 物件的指標,其中包含已擷取的筆劃集合。

傳回值

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

傳回碼 描述
S_OK
成功。
E_POINTER
參數包含無效的指標。
E_INK_EXCEPTION
方法內發生例外狀況。
E_INK_SOME_STROKES_NOT_EXTRACTED
並非所有筆劃都已擷取。
E_OUTOFMEMORY
無法配置記憶體來完成作業。
E_INVALIDARG
無效的擷取旗標。
REGDB_CLASSNOTREG
未註冊 Ink 物件。

備註

新的 InkDisp 物件會保留原始 InkDisp 物件的繪圖屬性、屬性和座標。

這個方法適用於建立新的 InkDisp 物件,而不需要從原始物件中刪除或剪下筆劃。

若要從已知的筆劃集合擷取筆劃,請呼叫 ExtractStrokes 方法

只有矩形內筆劃的部分會新增至新的 InkDisp 物件。

extractFlags 參數為 RemoveFromOriginalDefault 時,跨越矩形的任何筆劃都會分割,而矩形內的部分會從現有的 InkDisp 物件中移除。

規格需求

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

另請參閱

ExtractStrokes 方法

IInkDisp

InkDisp 類別

InkExtractFlags 列舉

InkRectangle 類別

InkStrokes 集合