共用方式為


IInkStrokeDisp::GetPacketData 方法 (msinkaut.h)

擷取 IInkStrokeDisp 物件內封包範圍的封包數據。

語法

HRESULT GetPacketData(
  [in, optional] long    Index,
  [in, optional] long    Count,
  [out, retval]  VARIANT *PacketData
);

參數

[in, optional] Index

選擇性。 以零起始之索引的起點,指向筆劃內的封包。 在 InkSelectionConstants 列舉類型中定義的預設值ISC_FirstElement會指定第一個封包。

[in, optional] Count

選擇性。 應該傳回的點封包數據集數目,從 startingIndex 參數中指定的封包開始。 在 InkSelectionConstants 列舉類型中定義的預設值ISC_AllElements,會指定組成筆劃數據的所有點。

[out, retval] PacketData

當這個方法傳回時,會包含帶正負號的32位整數陣列,其中包含筆劃中要求點的封包數據。 數位包含第一個點的數據,然後包含第二個點的數據等等。

如需 VARIANT 結構的詳細資訊,請參閱 使用 COM 連結庫

傳回值

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

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

備註

如果筆劃中的封包數目小於 startingIndexpointCount 參數的總和,則傳回的數據數位會包含封包資訊,以比所要求的計數少。

若要擷取封包數據的描述,請使用筆劃的 PacketDescription 屬性。 這個屬性會傳回全域唯一標識符陣列 (GUID) ,指出每個點的 GetPacketData 方法傳回哪些屬性值。 PacketProperty 常數包含可用的封包屬性 GUID。

規格需求

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

另請參閱

GetPacketDescriptionPropertyMetrics 方法

GetPacketValuesByProperty 方法

IInkStrokeDisp 介面

ItemSelectionConstants 列舉

PacketCount 屬性

PacketDescription 屬性

PacketSize 屬性

SetPacketValuesByProperty 方法