IInkStrokeDisp::SetPacketValuesByProperty 方法 (msinkaut.h)
修改特定屬性的封包值。
語法
HRESULT SetPacketValuesByProperty(
[in] BSTR bstrPropertyName,
[in] VARIANT PacketValues,
[in, optional] long Index,
[in, optional] long Count,
[out, retval] long *NumberOfPacketsSet
);
參數
[in] bstrPropertyName
來自 PacketProperty 常數的全域唯一標識碼 (GUID) 標識符,用來選取要設定的封包數據。 使用 PacketDescription 來判斷此筆劃的定義屬性。
[in] PacketValues
封包數據值的陣列。 如果陣列中的任何值不在 屬性的最小值或最大值之外,方法就會失敗。 若要判斷 屬性中的值範圍,請呼叫 GetPacketDescriptionPropertyMetrics 方法。
[in, optional] Index
選擇性。 要修改之封包的起始索引。 在 ItemSelectionConstants 列舉類型中定義的預設值ISC_FirstElement會指定第一個封包。
[in, optional] Count
選擇性。 指定要修改的筆劃中的封包數目,以及 PacketValues 中的值數目。 在 ItemSelectionConstants 列舉類型中定義的預設值ISC_AllElements會指定修改所有封包。
[out, retval] NumberOfPacketsSet
當這個方法傳回時,會包含設定的實際封包數目。
傳回值
這個方法可以傳回其中一個值。
傳回碼 | 描述 |
---|---|
|
成功。 |
|
參數包含無效的指標。 |
|
無效的 GUID 格式。 |
|
無效的 variant、索引 (超出範圍) 或屬性 GUID。 |
|
方法內發生例外狀況。 |
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows XP Tablet PC Edition [僅限傳統型應用程式] |
最低支援的伺服器 | 都不支援 |
目標平台 | Windows |
標頭 | msinkaut.h |
程式庫 | InkObj.dll |