共用方式為

IInkExtendedProperties：：Add 方法 (msinkaut.h)

  • 發行項

建立 並將 IInkExtendedProperty 物件新增至 IInkExtendedProperties 集合。

語法

HRESULT Add(
  [in]          BSTR                 Guid,
  [in]          VARIANT              Data,
  [out, retval] IInkExtendedProperty **InkExtendedProperty
);

參數

[in] Guid

新 IInkExtendedProperty 物件的名稱。 此名稱會以 BSTR 表示，以下列格式表示全域唯一標識碼 (GUID) ：

{dfc71f44-354b-4ca1-93d7-7459410b6343} (包括大括弧)

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

[in] Data

新 IInkExtendedProperty 對象的數據。

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

[out, retval] InkExtendedProperty

當這個方法傳回時，會包含新擴充屬性的指標。

傳回值

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

傳回碼 描述
S_OK
 成功。
E_POINTER
 參數包含無效的指標。
E_INVALIDARG
 使用者未指定數據。
CO_E_CLASSSTRING
 無效的 GUID 格式。
E_INK_EXCEPTION
 方法內發生例外狀況。
TPC_E_INVALID_STROKE
 筆劃無效。

備註

注意 您無法儲存空的 IInkExtendedProperty 物件。 對象必須包含數據，才能儲存數據。 例如，如果您嘗試將擴充屬性新增至筆劃以供稍後使用，則擴充屬性不包含任何數據時，就會擲回例外狀況。
 
下列類型是可接受的：
  • 位元組或 CHAR 陣列
  • 整數、浮點數、大型整數、雙精度浮點數、雙精度浮點數、日期或小數點的陣列
  • 布爾值 (，但不是布爾值的陣列)
  • BSTR (但不是 BSTR 的陣列)
  • Variants 的陣列。 以 IInkExtendedProperty 形式傳遞的所有變數組都必須是相同的類型，而且都是數值。 例如，不支援 BSTRS 的變數組、陣列數位列、VT_NULL和VT_EMPTY。
注意如果您使用 Guid 參數設定為已存在於 IInkExtendedProperties 集合中的 GUID 呼叫這個方法，新的數據將會取代該 GUID 的現有擴充屬性，而不是新增第二個元素。
 

規格需求

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

另請參閱

IInkExtendedProperties 介面

InkStrokes 集合