IInkStrokeDisp::Split 方法 (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 物件的指標。
傳回值
這個方法可以傳回其中一個值。
傳回碼 | 描述 |
---|---|
|
成功。 |
|
參數包含無效的指標。 |
|
無法配置 Stroke 處理程式協助程序物件。 |
|
參數無效。 |
|
非預期的參數或屬性類型。 |
|
方法內發生例外狀況。 |
備註
此方法會在筆劃集的原始筆劃之後立即插入新的筆劃,並重新編號其餘筆劃索引。
分割 IInkStrokeDisp 時,筆劃的開頭部分會維持原始 IInkStrokeDisp 的標識符。 IInkStrokeDisp 的結尾部分會變成標識符大於最高 IInkStrokeDisp 的新 IInkStrokeDisp。 如果原始 的 IInkStrokeDisp 位於 InkStrokes 集合中, (Ink.Strokes) ,則只有開頭部分會保留在該集合中。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows XP Tablet PC Edition [僅限傳統型應用程式] |
最低支援的伺服器 | 都不支援 |
目標平台 | Windows |
標頭 | msinkaut.h |
程式庫 | InkObj.dll |