IInkStrokeDisp::Split method (msinkaut.h)

在劃程指定位置分割行程。

語法

HRESULT Split(
  [in]          float          SplitAt,
  [out, retval] IInkStrokeDisp **NewStroke
);

參數

[in] SplitAt

浮點指數值代表筆劃分割的位置。

浮點索引是一種浮點數值,代表筆劃中兩點之間的某個位置。 舉例來說,若0.0是筆劃的第一點,1.0是筆劃的第二點,則0.5位於第一點與第二點的中間。 同樣地,浮點指數值為37.25,代表位於筆劃第37點與第38點之間線上的25%位置。
 

[out, retval] NewStroke

當此方法回傳時,包含一個指向由分割操作建立的新 IInkStrokeDisp 物件的指標。

返回值

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

回傳碼 說明
S_OK
成功。
E_POINTER
某個參數包含無效指標。
E_OUTOFMEMORY
無法分配 Stroke handler 助手物件。
E_INVALIDARG
該參數無效。
E_UNEXPECTED
非預期的參數或屬性類型。
E_INK_EXCEPTION
方法中出現了例外。

備註

此方法會在筆劃集中的原始筆劃後立即插入新筆劃,並重新編號剩餘的筆劃索引。

IInkStrokeDisp 被拆分時,筆劃的起始部分仍保留原始 IInkStrokeDisp 的 ID。 IInkStrokeDisp 的末端部分會變成一個新的 IInkStrokeDisp,其 ID 比最高的 IInkStrokeDisp ID 大一。 如果原本的 IInkStrokeDispInkStrokes 集合中(除了 Ink.Strokes),該集合中只有開頭部分。

要求

需求 價值
最低支援的用戶端 Windows XP 平板電腦版【僅限桌面應用程式】
支援的最低伺服器 不支援
目標平臺 Windows
Header msinkaut.h

另請參閱

IInkStrokeDisp 介面