Сообщения InkEdit (только Win32)
Элемент управления InkEdit является суперклассом элемента управления RichEdit . Каждое сообщение RichEdit в большинстве случаев передается напрямую и имеет точно такой же эффект, как в RichEdit. Это также относится к сообщениям о событиях.
Чтобы отправить эти сообщения, вызовите функцию SendMessage со следующими параметрами:
| C++ |
|---|
|
Сообщение
Родительское окно элемента управления InkEdit получает уведомления о событиях через сообщение WM_NOTIFY:
LRESULT CALLBACK WindowProc(
HWND hWnd, // handle to window
UINT uMsg, // WM_NOTIFY
WPARAM wParam, // InkEdit control identifier
LPARAM lParam // see documentation for notification messages
);
| Получение и установка сообщения | Описание |
|---|---|
| EM_GETINKMODE |
Возвращает режим рукописного ввода элемента управления InkEdit . Параметры Это сообщение не имеет параметров; wParam и lParam должны иметь значение 0. Возвращаемые значения: Это сообщение возвращает одно из значений, определенных в перечислении InkMode , которое указывает, отключена ли коллекция рукописного ввода, собирается ли рукописный ввод или собираются ли рукописные фрагменты и жесты. |
| EM_SETINKMODE |
Задает режим рукописного ввода элемента управления InkEdit . Параметры Wparam Задает одно из значений перечисления InkMode , которое указывает, отключена ли коллекция рукописного ввода, собирается ли рукописный ввод или собирается ли рукописный ввод и жесты. Lparam Этот параметр не используется; значение должно быть 0. Возвращаемые значения: Это сообщение возвращает значение 0 в случае успешного выполнения или ненулевое значение при возникновении ошибки. Примечания: Это следует использовать, только если EM_GETSTATUS возвращает IES_Idle. |
| EM_GETINKINSERTMODE |
Возвращает режим вставки рукописного ввода элемента управления InkEdit . Параметры Это сообщение не имеет параметров; wParam и lParam должны иметь значение 0. Возвращаемые значения: Это сообщение возвращает одно из значений перечисления InkInsertMode , которое указывает, вставляется ли рукописный ввод в элемент управления в виде текста или рукописного ввода. |
| EM_SETINKINSERTMODE |
Задает режим вставки рукописного ввода элемента управления InkEdit . Отправка этого сообщения не оказывает влияния при использовании с любой установленной операционной системой, кроме Microsoft Windows XP Tablet PC Edition. Параметры Wparam Задает одно из значений перечисления InkInsertMode , которое указывает, вставляется ли рукописный ввод в элемент управления в виде текста или рукописного ввода. Lparam Этот параметр не используется; значение должно быть 0. Возвращаемые значения: Это сообщение возвращает значение 0 в случае успешного выполнения или ненулевое значение при возникновении ошибки. |
| EM_GETDRAWATTR |
Возвращает текущие атрибуты рисования элемента управления InkEdit . Параметры Wparam Этот параметр не используется; значение должно быть 0. Lparam Указывает указатель (IInkDrawingAttributes **pDrawAttr) для получения текущего объекта InkDrawingAttributes . Возвращаемые значения: Это сообщение возвращает значение 0 в случае успешного выполнения или ненулевое значение при возникновении ошибки. |
| EM_SETDRAWATTR |
Задает атрибуты рисования, которые будут использоваться для будущей коллекции рукописного ввода. Параметры Wparam Этот параметр не используется; значение должно быть 0. Lparam Указывает указатель (IInkDrawingAttributes *pDrawAttr) на объект InkDrawingAttributes . Возвращаемые значения: Это сообщение возвращает значение 0 в случае успешного выполнения или ненулевое значение при возникновении ошибки. |
| EM_GETRECOTIMEOUT |
Возвращает время ожидания распознавания (в миллисекундах) для элемента управления InkEdit . Параметры Это сообщение не имеет параметров; wParam и lParam должны иметь значение 0. Возвращаемые значения: Это сообщение возвращает время ожидания распознавания в миллисекундах. |
| EM_SETRECOTIMEOUT |
Задает время ожидания распознавания (в миллисекундах) для элемента управления InkEdit . Параметры Wparam Указывает время ожидания распознавания в миллисекундах. Lparam Этот параметр не используется; значение должно быть 0. Возвращаемые значения: Это сообщение возвращает значение 0 в случае успешного выполнения или ненулевое значение при возникновении ошибки. |
| EM_GETGESTURESTATUS |
Получает состояние жеста для элемента управления InkEdit . Параметры Wparam Указывает тип жеста, как определено в перечислении InkApplicationGesture . Lparam Этот параметр не используется; значение должно быть 0. Возвращаемые значения: Это сообщение возвращает значение TRUE , если элемент управления InkEdit подписывается на жест, или false , если элемент управления InkEdit не подписан на жест. |
| EM_SETGESTURESTATUS |
Задает состояние жеста для элемента управления InkEdit . Параметры Wparam Указывает тип жеста, как определено в перечислении InkApplicationGesture . Lparam Указывает ЗНАЧЕНИЕ TRUE , если подписка на жест включена, или FALSE , если прослушивание жеста не включено. Возвращаемые значения: Это сообщение возвращает значение 0 в случае успешного выполнения или ненулевое значение при возникновении ошибки. Примечания: Это следует использовать, только если EM_GETSTATUS возвращает IES_Idle. |
| EM_GETRECOGNIZER |
Возвращает распознаватель, который использует элемент управления InkEdit . Параметры Wparam Этот параметр не используется; значение должно быть 0. Lparam Указывает указатель на IInkRecognizer* для получения объекта IInkRecognizer , который использует элемент управления InkEdit . Возвращаемые значения: Это сообщение возвращает значение 0 в случае успешного выполнения или ненулевое значение при возникновении ошибки. |
| EM_SETRECOGNIZER |
Задает распознаватель, который использует элемент управления InkEdit . Если для элемента управления InkEdit используется factoid , его необходимо применить повторно после отправки этого сообщения. Параметры Wparam Этот параметр не используется; значение должно быть 0. Lparam Указывает указатель на IInkRecognizer* для задания объекта IInkRecognizer , используемого элементом управления InkEdit для последующего использования. Возвращаемые значения: Это сообщение возвращает значение 0 в случае успешного выполнения или ненулевое значение при возникновении ошибки. Примечания: Этот параметр следует использовать только в том случае, если EM_GETSTATUS возвращает IES_Idle. |
| EM_GETFACTOID |
Возвращает factoid , используемый для распознавания. Параметры Wparam Этот параметр не используется; Значение должно быть 0. Lparam Указывает указатель на BSTR для получения строки factoid. Возвращаемые значения: Это сообщение возвращает значение 0 при успешном выполнении или ненулевое значение при возникновении ошибки. |
| EM_SETFACTOID |
Задает factoid , используемый для распознавания. Параметры Wparam Этот параметр не используется; Значение должно быть 0. Lparam Указывает BSTR, содержащий строку factoid. Возвращаемые значения: Это сообщение возвращает значение 0 при успешном выполнении или ненулевое значение при возникновении ошибки. Примечания: Этот параметр следует использовать только в том случае, если EM_GETSTATUS возвращает IES_Idle. |
| EM_GETSELINK |
Возвращает рукописный ввод в выделенном фрагменте. Рукописные фрагменты должны быть распознаны перед доступом к этому сообщению. Если он не распознается первым, EM_GETSELINK всегда возвращает ноль объектов InkDisp . Параметры Wparam Этот параметр не используется; Значение должно быть 0. Lparam Указывает указатель на VARIANT для получения безопасного массива для получения объектов InkDisp в текущем выделенном фрагменте. Возвращаемые значения: Это сообщение возвращает значение 0 при успешном выполнении или ненулевое значение при возникновении ошибки. |
| EM_SETSELINK |
Задает рукописный ввод в выделенном фрагменте. Отправка этого сообщения не действует при использовании с любой установленной операционной системой, кроме Windows XP Tablet PC Edition. Параметры Wparam Этот параметр не используется; Значение должно быть 0. Lparam Указывает указатель на variant с безопасным массивом объектов InkDisp для замены текущего выделенного фрагмента. Возвращаемые значения: Это сообщение возвращает значение 0 при успешном выполнении или ненулевое значение при возникновении ошибки. |
| EM_GETSELINKDISPLAYMODE |
Возвращает текущий внешний вид рукописного ввода в выбранном диапазоне, используя одно из значений перечисления InkDisplayMode . Параметры Это сообщение не имеет параметров; wParam и lParam должны иметь значение 0. Возвращаемые значения: Это сообщение возвращает одно из значений перечисления InkDisplayMode (IDM_Text или IDM_Ink), которое указывает, как выделение отображается в элементе управления . |
| EM_SETSELINKDISPLAYMODE |
Задает внешний вид рукописного ввода в выбранном диапазоне с помощью одного из значений перечисления InkDisplayMode . Параметры Wparam Этот параметр не используется; Значение должно быть 0. Lparam Указывает, как рукописный ввод отображается в выбранном диапазоне, как определено в перечислении InkDisplayMode . Возвращаемые значения: Это сообщение возвращает значение 0 при успешном выполнении или ненулевое значение при возникновении ошибки. Отправка этого сообщения не действует при использовании с любой установленной операционной системой, кроме Windows XP Tablet PC Edition. |
| EM_GETSTATUS |
Возвращает состояние элемента управления InkEdit . Параметры Это сообщение не имеет параметров; wParam и lParam должны иметь значение 0. Возвращаемые значения: Это сообщение возвращает одно из значений перечисления InkEditStatus , которое указывает, является ли элемент управления бездействующей, собирает рукописный ввод или распознает рукописный ввод. |
| EM_RECOGNIZE |
Принудительное распознавание. Параметры Это сообщение не имеет параметров; wParam и lParam должны иметь значение 0. Возвращаемые значения: Это сообщение возвращает значение 0 при успешном выполнении или ненулевое значение при возникновении ошибки. |
| EM_GETMOUSEICON |
Возвращает значок мыши. Параметры Wparam Этот параметр не используется; Значение должно быть 0. Lparam Указывает указатель HICON*, заполненный текущим элементом MouseIcon HICON. Это может быть значение HICON или NULL . Возвращаемые значения: Это сообщение возвращает значение 0 при успешном выполнении или ненулевое значение при возникновении ошибки. |
| EM_SETMOUSEICON |
Задает значок мыши. Параметры Wparam Задает значение BOOLEAN, которое имеет значение TRUE , если элемент управления InkEdit должен владеть дескриптором HICON, или FALSE , если элемент управления InkEdit не должен владеть дескриптором HICON. Если элемент управления InkEdit является владельцем HICON, он надлежащим образом заботится о HICON и уничтожает его. В противном случае вызывающий объект является владельцем HICON и отвечает за его удаление. Lparam Задает новое значение HICON. Используйте значение NULL , чтобы очистить значение. Значение по умолчанию — NULL. Возвращаемые значения: Это сообщение возвращает значение 0 при успешном выполнении или ненулевое значение при возникновении ошибки. |
| EM_GETMOUSEPOINTER |
Возвращает указатель мыши. Параметры Wparam Этот параметр не используется; Значение должно быть 0. Lparam Содержит указатель InkMousePointer*, заполненный текущим значением MousePointer . Это поведение аналогично свойству InkCollector::get_MousePointer . Возвращаемые значения: Это сообщение возвращает значение 0 при успешном выполнении или ненулевое значение при возникновении ошибки. |
| EM_SETMOUSEPOINTER |
Задает указатель мыши. Параметры Wparam Этот параметр не используется; Значение должно быть 0. Lparam Содержит новое значение MousePointer , определенное в перечислении InkMousePointer . Это поведение аналогично свойству InkCollector::p ut_MousePointer . Возвращаемые значения: Это сообщение возвращает значение 0 при успешном выполнении или ненулевое значение при возникновении ошибки. |
| EM_GETUSEMOUSEFORINPUT |
Возвращает состояние того, обрабатывается ли ввод с помощью мыши как входные данные с помощью пера. Параметры Это сообщение не имеет параметров; wParam и lParam должны иметь значение 0. Возвращаемые значения: Это сообщение возвращает 0 , если false , или 1, если true. |
| EM_SETUSEMOUSEFORINPUT |
Задает состояние того, обрабатывается ли ввод с помощью мыши как вход с помощью пера. Параметры Wparam Задает логическое значение, определяющее, следует ли обрабатывать входные данные с помощью мыши как входные данные с помощью пера. Lparam Этот параметр не используется; значение должно быть 0. Возвращаемые значения: Это сообщение возвращает значение 0 в случае успешного выполнения или ненулевое значение при возникновении ошибки. Примечания: Это следует использовать, только если EM_GETSTATUS возвращает IES_Idle. |
| Сообщение уведомления о событии | Описание |
|---|---|
| IECN_STROKE |
Уведомляет родительское окно элемента управления InkEdit о создании IInkStrokeDisp . Оно отправляется в WM_NOTIFY сообщении со следующими параметрами. Параметры Wparam Указывает идентификатор элемента управления, отправляющего сообщение. Lparam Указывает указатель на структуру IEC_STROKEINFO . Возвращаемые значения: Клиент возвращает 0, чтобы принять штрих, и 1 для отмены штриха. |
| IECN_GESTURE |
Уведомляет родительское окно элемента управления InkEdit о распознавании жеста. Оно отправляется в WM_NOTIFY сообщении со следующими параметрами. Параметры Wparam Указывает идентификатор элемента управления, отправляющего сообщение. Lparam Указывает указатель на структуру IEC_GESTUREINFO . Возвращаемые значения: Клиент возвращает 0, чтобы принять жест, и 1 для отмены жеста. |
| IECN_RECOGNITIONRESULT |
Уведомляет родительское окно элемента управления InkEdit о том, что произошло распознавание. Оно отправляется в WM_NOTIFY сообщении со следующими параметрами. Параметры Wparam Указывает идентификатор элемента управления, отправляющего сообщение. Lparam Указывает указатель на структуру IEC_RECOGNITIONRESULTINFO . Возвращаемые значения: Клиент возвращает значение 0, если обрабатывает сообщение. |