Поделиться через

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

  • Статья

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

Синтаксис

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_NCACTIVATE, WM_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

IInkOverlay

Класс InkOverlay