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

Сообщения 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
 Возвращает время ожидания распознавания в миллисекундах для элемента управления in 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. Если Factoid используется для элемента управления InkEdit, его необходимо повторно применить после отправки этого сообщения.
Параметры:
wParamЭтот параметр не используется; оно должно быть 0.
lParamУказывает указатель на IInkRecognizer*, чтобы задать объект IInkRecognizer, используемый элементом управления InkEdit для последующего использования.
Возвращаемые значения:
Это сообщение возвращает значение 0 при успешном выполнении или ненулевом выполнении ошибки.
Замечания:
Это следует использовать только в том случае, если EM_GETSTATUS возвращает IES_Idle.
EM_GETFACTOID
 Возвращает Factoid, используемый для распознавания.
Параметры:
wParamЭтот параметр не используется; оно должно быть 0.
lParamУказывает указатель на BSTR для получения строки фактоида.
Возвращаемые значения:
Это сообщение возвращает значение 0 при успешном выполнении или ненулевом выполнении ошибки.
EM_SETFACTOID
 Задает Factoid для распознавания.
Параметры:
wParamЭтот параметр не используется; оно должно быть 0.
lParamУказывает BSTR, содержащий фактоидную строку.
Возвращаемые значения:
Это сообщение возвращает значение 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 может быть либо 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