IInkStrokeDisp：：GetPacketValuesByProperty 方法 (msinkaut.h)

發行項
03/13/2024

從筆劃中的一或多個封包擷取已知封包屬性的數據。

語法

HRESULT GetPacketValuesByProperty(
  [in]           BSTR    PropertyName,
  [in, optional] long    Index,
  [in, optional] long    Count,
  [out, retval]  VARIANT *PacketValues
);

參數

[in] PropertyName

來自 PacketProperty 常數的標識碼，用來選取擷取的封包數據。

如需 BSTR 數據類型的詳細資訊，請參閱使用 COM 連結庫。

[in, optional] Index

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

[in, optional] Count

選擇性。組成筆劃數據的點數。在 InkSelectionConstants 列舉類型中定義的預設值ISC_AllElements，會指定組成筆劃數據的所有點。

[out, retval] PacketValues

當這個方法傳回時，會包含帶正負號 32 位整數的陣列，指定筆劃所要求之每個點的 PacketProperty 值。

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

傳回值

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

傳回碼	描述
S_OK	成功。
TPC_E_INVALID_STROKE	筆劃無效。
E_POINTER	參數包含無效的指標。
E_FAIL	發生未指定的錯誤。
E_OUTOFMEMORY	無法配置封包數據陣列。
E_INVALIDARG	無效的索引、計數或封包屬性。
E_INK_EXCEPTION	方法內發生例外狀況。
CO_E_CLASSSTRING	無效的 GUID 格式。

備註

特定 IInkStrokeDisp 物件上可能無法使用特定的封包屬性。平板電腦可能有多個平板電腦供用戶輸入。 InkTablets 集合包含連接至平板電腦的所有平板電腦清單。使用 IsPacketPropertySupported 方法來判斷特定 IInkTablet 物件或所有可用的平板電腦是否支援特定封包屬性。此外，使用筆跡收集器的DesiredPacketDescription 屬性來控制在新的筆劃上收集哪些封包屬性。

規格需求

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