IInkDisp：：ExtractWithRectangle 方法 (msinkaut.h)

發行項
03/05/2024

使用已知的矩形來判斷要擷取的筆劃，從現有的 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 參數為 RemoveFromOriginal 或 Default 時，跨越矩形的任何筆劃都會分割，而矩形內的部分會從現有的 InkDisp 物件中移除。

規格需求

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