Поделиться через

Метод 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 . Объект должен содержать данные, прежде чем его можно будет сохранить. Например, при попытке добавить расширенные свойства в росчерк для последующего использования создается исключение, если расширенное свойство не содержит данных.
 
Допустимы следующие типы:
  • Массив байтов или символов
  • Массивы целых чисел, числа с плавающей точкой, большие целые числа, двойные числа, даты или десятичные разряды
  • Логические значения (но не массивы логических значений)
  • BSTR (но не массивы BSTR)
  • Массивы вариантов. Все массивы вариантов, передаваемые как IInkExtendedProperty , должны иметь один и тот же тип и быть числовыми. Например, массивы вариантов BSTRS, массивы массивов, VT_NULL и VT_EMPTY не поддерживаются.
Примечание При вызове этого метода с параметром GUID , который уже существует в коллекции IInkExtendedProperties , новые данные заменят существующее расширенное свойство для этого GUID вместо добавления второго элемента.
 

Требования

Требование Значение
Минимальная версия клиента Windows XP Tablet PC Edition [только классические приложения]
Минимальная версия сервера Ни одна версия не поддерживается
Целевая платформа Windows
Header msinkaut.h
Библиотека InkObj.dll

См. также раздел

Интерфейс IInkExtendedProperties

Коллекция InkStrokes