Метод IInkCollector::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_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

IInkCollector

Класс InkCollector