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

Статья
08/24/2023

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

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

Синтаксис

HRESULT put_Enabled(
  VARIANT_BOOL Collecting
);

Параметры

Collecting

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

None

Remarks

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

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

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

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

При завершении работы приложения рекомендуется задать для параметра Enabled значение 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