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 連結庫。
傳回值
這個方法可以傳回其中一個值。
傳回碼 | 描述 |
---|---|
|
成功。 |
|
參數包含無效的指標。 |
|
發生未指定的錯誤。 |
|
無法配置 Stroke 處理程式協助程序物件。 |
|
筆劃無效。 |
|
方法內發生例外狀況。 |
|
非預期的參數或屬性類型。 |
備註
如果筆劃中的封包數目小於 startingIndex 和 pointCount 參數的總和,則傳回的數據數位會包含封包資訊,以比所要求的計數少。
若要擷取封包數據的描述,請使用筆劃的 PacketDescription 屬性。 這個屬性會傳回全域唯一標識符陣列 (GUID) ,指出每個點的 GetPacketData 方法傳回哪些屬性值。 PacketProperty 常數包含可用的封包屬性 GUID。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows XP Tablet PC Edition [僅限傳統型應用程式] |
最低支援的伺服器 | 都不支援 |
目標平台 | Windows |
標頭 | msinkaut.h |
程式庫 | InkObj.dll |