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

Метод IInkCursorButtons::Item (msinkaut.h)

  • Статья

Извлекает объект IInkCursorButton по указанному индексу или строкового идентификатора в коллекции IInkCursorButtons .

Синтаксис

HRESULT Item(
  [in]          VARIANT          Identifier,
  [out, retval] IInkCursorButton **Button
);

Параметры

[in] Identifier

Отсчитываемый от нуля индекс или идентификатор BSTR получаемого объекта IInkCursorButton .

Дополнительные сведения о типах данных VARIANT и BSTR см. в разделе Использование библиотеки COM.

[out, retval] Button

При возврате содержит объект IInkCursorButton по указанному индексу в коллекции IInkCursorButtons .

Возвращаемое значение

Этот метод может возвращать одно из этих значений.

Код возврата Описание
S_OK
 Успешно.
E_POINTER
 Параметр содержит недопустимый указатель.
E_FAIL
 Произошла неизвестная ошибка.
CO_E_CLASSTRING
 Недопустимый формат GUID.
DISP_E_TYPEMISMATCH
 Один из параметров не является допустимым типом VARIANT.
E_INVALIDARG
 Недопустимый аргумент.
E_UNEXPECTED
 Непредвиденный параметр или тип свойства.
REGDB_CLASSNOTREG
 Тип объекта не зарегистрирован.
E_OUTOFMEMORY
 Не удается выделить память для завершения операции.
E_INK_EXCEPTION
 В методе произошло исключение.
TPC_E_RECOGNIZER_NOT_REGISTERED
 Раздел реестра распознавателей поврежден или ваша среда не поддерживает распознавание рукописного ввода.

Комментарии

Ошибка возникает, если индекс не соответствует ни одному из существующих элементов коллекции.

Метод Item принимает входной аргумент типа VARIANT. Однако подтип этой переменной должен быть целым числом или строковым (BSTR). Это означает, что при использовании поздней привязки, например при использовании языка сценариев, необходимо передать аргумент в виде литерала STRING, а не использовать переменную.

Требования

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

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

Интерфейс IInkCursorButton

Интерфейс IInkCursorButtons