IInkDisp::D eleteStrokes 方法 (msinkaut.h)

InkDisp 物件的 Strokes 集合中刪除 InkStrokes 集合。

語法

HRESULT DeleteStrokes(
  [in, optional] IInkStrokes *Strokes
);

參數

[in, optional] Strokes

選擇性。 指定要從 InkDisp 物件中刪除的筆劃集合。 預設值是 NULL

傳回值

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

傳回碼 描述
S_OK
成功。
E_POINTER
參數包含無效的指標。
E_OUTOFMEMORY
無法配置用來執行作業的記憶體。
E_FAIL
發生未指定的錯誤。
E_INK_MISMATCHED_INK_OBJECT
筆劃的 InkDisp 物件必須符合已知的 InkDisp 物件。
E_INK_EXCEPTION
方法內發生例外狀況。
E_UNEXPECTED
非預期的參數或屬性類型。

備註

如果未傳入 InkStrokes 集合,這個方法會刪除 InkDisp 物件中的所有筆劃。 若要一次只刪除一個筆劃,請呼叫 DeleteStroke 方法。

如果已刪除的筆劃不會落在 InkDisp 物件集合的筆劃結尾,InkDisp 物件中的剩餘筆劃索引就會重新編號。

注意當集合中包含的筆劃從 InkDisp 物件中刪除時,InkStrokes 集合的內容會變成無效。
 
當用戶主動配置筆跡時呼叫DeleteStrokes可能會導致錯誤。

規格需求

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

另請參閱

DeleteStroke 方法

IInkDisp

InkDisp 類別

InkStrokes 集合