Метод IInkCollector::get_Enabled (msinkaut.h)

Статья
08/24/2023

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

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

Синтаксис

HRESULT get_Enabled(
  VARIANT_BOOL *Collecting
);

Параметры

Collecting

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

None

Remarks

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

Если объект не включен, события не отображаются.

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

Нельзя задать для свойства Enabledзначение FALSE , пока объект собирает рукописный ввод (свойство CollectingInk имеет значение TRUE).

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

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

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

Свойства

Методы

Требования


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