Share via

Сообщения InkEdit (только Win32)

  • Статья

Элемент управления InkEdit является суперклассом элемента управления RichEdit . Каждое сообщение RichEdit в большинстве случаев передается напрямую и имеет точно такой же эффект, как в RichEdit. Это также относится к сообщениям о событиях.

Чтобы отправить эти сообщения, вызовите функцию SendMessage со следующими параметрами:

C++ 
LRESULT SendMessage(  HWND hWnd,      // handle to destination window  UINT Msg,       // message  WPARAM wParam,  // first message parameter  LPARAM lParam   // second message parameter);

Сообщение

Родительское окно элемента управления 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, если обрабатывает сообщение.

Применение

Структура IEC_GESTUREINFO (только Win32)

Структура IEC_STROKEINFO (только Win32)

Структура IEC_RECOGNITIONRESULTINFO (только Win32)

Свойство MousePointer

Перечисление InkEditStatus

Перечисление InkInsertMode

Перечисление InkMode

Интерфейс IInkCursor

Класс InkDrawingAttributes

Интерфейс IInkRecognitionResult

Интерфейс IInkRecognizer

Класс InkDisp

Интерфейс IInkGesture