在劃程指定位置分割行程。
語法
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 物件的指標。
返回值
這個方法可以傳回其中一個值。
| 回傳碼 | 說明 |
|---|---|
|
成功。 |
|
某個參數包含無效指標。 |
|
無法分配 Stroke handler 助手物件。 |
|
該參數無效。 |
|
非預期的參數或屬性類型。 |
|
方法中出現了例外。 |
備註
此方法會在筆劃集中的原始筆劃後立即插入新筆劃,並重新編號剩餘的筆劃索引。
當 IInkStrokeDisp 被拆分時,筆劃的起始部分仍保留原始 IInkStrokeDisp 的 ID。 IInkStrokeDisp 的末端部分會變成一個新的 IInkStrokeDisp,其 ID 比最高的 IInkStrokeDisp ID 大一。 如果原本的 IInkStrokeDisp 在 InkStrokes 集合中(除了 Ink.Strokes),該集合中只有開頭部分。
要求
| 需求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows XP 平板電腦版【僅限桌面應用程式】 |
| 支援的最低伺服器 | 不支援 |
| 目標平臺 | Windows |
| Header | msinkaut.h |