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


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

Извлекает объект IInkTablet по указанному индексу в коллекции InkTablets .

Синтаксис

HRESULT Item(
  [in]          long       Index,
  [out, retval] IInkTablet **Tablet
);

Параметры

[in] Index

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

[out, retval] Tablet

При возврате этого метода содержит указатель на объект IInkTablet по указанному индексу в коллекции InkTablets .

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

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

Код возврата Описание
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
Раздел реестра распознавателей поврежден или ваша среда не поддерживает распознавание рукописного ввода.

Комментарии

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

Примечание Эту функцию можно повторно ввести при вызове в определенных обработчиках сообщений, что приводит к непредвиденным результатам. Избегайте повторного вызова при обработке любого из следующих сообщений: WM_ACTIVATE, WM_ACTIVATEAPP, WM_NCACTIVATEWM_PAINT; WM_SYSCOMMAND , если для wParam задано значение SC_HOTKEY или SC_TASKLIST; и WM_SYSKEYDOWN (при обработке сочетаний клавиш Alt-Tab или Alt-Esc). Это проблема с однопоточными приложениями модели подразделения.
 

Требования

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

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

Интерфейс IInkTablet

IInkTablets

Коллекция InkTablets