Метод IInkPicture::get_InkEnabled (msinkaut.h)

Статья
08/25/2023

Возвращает или задает значение, указывающее, собирает ли элемент управления InkPicture входные данные пером (пакеты в воздухе, курсор в событиях диапазона и т. д.).

Это свойство является чтением и записью.

Синтаксис

HRESULT get_InkEnabled(
  VARIANT_BOOL *Collecting
);

Параметры

Collecting

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

None

Remarks

Элемент управления InkPicture собирает рукописный ввод в Windows Vista, Microsoft Windows XP Tablet PC Edition или любом выпуске Windows 2000, Windows Server 2003 или Windows XP, в котором установлен пакет sdk для Windows XP Tablet PC Edition. Однако распознавание рукописного ввода происходит только в том случае, если установлен выпуск Windows Vista, Windows XP Tablet PC Edition или пакет распознавателя.

В любом выпуске Windows 2000, Windows Server 2003 или Windows XP, отличном от Windows XP Tablet PC Edition, свойство InkEnabled всегда имеет значение FALSE , если пакет SDK для планшетного компьютера не установлен.

Если входной прямоугольник окна включенного объекта (заданный в конструкторе или с помощью метода SetWindowInputRectangle) перекрывает входной прямоугольник окна другого включенного объекта, возвращается ошибка E_INK_OVERLAPPING_INPUT_RECT.

Примечание Перекрытие может происходить без ошибок, если в любой момент включен только один из входных прямоугольников.

Хотя элемент управления InkPicture не включен, вы не получаете никаких событий.

Если свойству Enabled элемента управления InkPicture контейнера присвоено значение VARIANT_FALSE, все содержащиеся в нем элементы управления также отключаются.

Нельзя задать для этого свойства значение VARIANT_FALSE пока элемент управления InkPicture собирает рукописный ввод (свойство CollectingInkVARIANT_TRUE).

Чтобы получить наилучшие результаты, присвойте свойству Enabledзначение VARIANT_FALSE при завершении работы приложения.

Это свойство должно иметь значение VARIANT_FALSE перед заданием или вызовом определенных свойств и методов элемента управления. При попытке изменить указанные свойства или вызвать указанные методы возникает ошибка. Следующие свойства и методы нельзя задать или вызвать, если для свойства Enabled сначала не задано значение VARIANT_FALSE:

Свойства:
Методы:
- Метод SetAllTabletsMode
- Метод SetSingleTabletIntegratedMode

Требования

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