Share via

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 物件的指標。

傳回值

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

傳回碼 描述
S_OK
 成功。
E_POINTER
 參數包含無效的指標。
E_OUTOFMEMORY
 無法配置 Stroke 處理程式協助程序物件。
E_INVALIDARG
 參數無效。
E_UNEXPECTED
 非預期的參數或屬性類型。
E_INK_EXCEPTION
 方法內發生例外狀況。

備註

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

分割 IInkStrokeDisp 時，筆劃的開頭部分會維持原始 IInkStrokeDisp 的標識符。 IInkStrokeDisp 的結尾部分會變成標識符大於最高 IInkStrokeDisp 的新 IInkStrokeDisp。 如果原始 的 IInkStrokeDisp 位於 InkStrokes 集合中， (Ink.Strokes) ，則只有開頭部分會保留在該集合中。

規格需求

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

另請參閱

IInkStrokeDisp 介面