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

Статья
03/13/2024

Изменяет прямоугольник окна в пикселях, в котором рисуется рукописный ввод.

Синтаксис

HRESULT SetWindowInputRectangle(
  [in] IInkRectangle *WindowInputRectangle
);

Параметры

[in] WindowInputRectangle

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

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

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

Код возврата	Описание
S_OK	Успешно.
E_POINTER	Параметр содержал недопустимый указатель.
E_INVALIDARG	Недопустимые координаты прямоугольника (например, ширина/высота 0).
E_INK_COLLECTOR_BUSY	Не удается обновить сопоставления в середине росчерка.
E_INK_EXCEPTION	В методе произошло исключение.
E_INK_OVERLAPPING_INPUT_RECT	Прямоугольник ввода окна перекрывается с прямоугольником ввода окна включенного объекта InkCollector.

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

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

По умолчанию входной прямоугольник окна имеет значение {0,0,0,0}. Этот прямоугольник по умолчанию соответствует размеру всего окна.

Чтобы сбросить входной прямоугольник окна до его поведения по умолчанию (пустой прямоугольник с координатами {0,0,0,0}), передайте {0,0,0,0} вызов SetWindowInputRectangle, а не NULL.

Нельзя передать прямоугольник, в котором значение свойства Right меньше значения свойства Left ; или , где значение свойства Bottom меньше значения свойства Top . Например, недопустимый прямоугольник с параметрами {500, 500, 400, 400}.

Осторожностью Если задать прямоугольник ввода окна так, чтобы он перекрывал элемент управления разделением или границы окна, при изменении размера окна могут возникнуть непредсказуемые результаты.

Примечание Вызов этого метода в определенных обработчиках сообщений может привести к повторному вводу базовой функции, что приведет к непредвиденным результатам. Избегайте повторного вызова при обработке любого из следующих сообщений: 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

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

Свойство Enabled

Метод GetWindowInputRectangle

IInkPicture

InkPicture