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
Library InkObj.dll

另请参阅

IInkExtendedProperties 接口

InkStrokes 集合