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

Статья
08/25/2023

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

Это свойство доступно для чтения и записи.

Синтаксис

HRESULT put_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