Mensajes InkEdit (solo Win32)

  • Artículo

El control InkEdit es una superclase del control RichEdit . Cada mensaje RichEdit se pasa, directamente en la mayoría de los casos, y tiene exactamente el mismo efecto que en RichEdit. Esto también se aplica a los mensajes de notificación de eventos.

Para enviar estos mensajes, llame a la función SendMessage con los parámetros siguientes:

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

Message

La ventana primaria del control InkEdit recibe mensajes de notificación de eventos a través del mensaje 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
);
Obtener o establecer mensaje Descripción
EM_GETINKMODE
 Obtiene el modo de entrada manuscrita del control InkEdit .
Parámetros:
Este mensaje no tiene parámetros; wParam y lParam deben ser 0.
Valores devueltos:
Este mensaje devuelve uno de los valores definidos en la enumeración InkMode , que especifica si la colección de entrada de lápiz está deshabilitada, si se recopila la entrada de lápiz o si se recopilan la entrada de lápiz y los gestos.
EM_SETINKMODE
 Establece el modo de entrada manuscrita del control InkEdit .
Parámetros:
Wparam Especifica uno de los valores de la enumeración InkMode , que especifica si la colección de entrada de lápiz está deshabilitada, si se recopila la entrada de lápiz o si se recopilan la entrada de lápiz y los gestos.
Lparam Este parámetro no se usa; debe ser 0.
Valores devueltos:
Este mensaje devuelve 0 si es correcto o distinto de cero si se produce un error.
Comentarios:
Esto solo se debe usar si el EM_GETSTATUS devuelve IES_Idle.
EM_GETINKINSERTMODE
 Obtiene el modo de inserción de lápiz del control InkEdit .
Parámetros:
Este mensaje no tiene parámetros; wParam y lParam deben ser 0.
Valores devueltos:
Este mensaje devuelve uno de los valores de la enumeración InkInsertMode , que especifica si la entrada de lápiz se inserta en el control como texto o como entrada manuscrita.
EM_SETINKINSERTMODE
 Establece el modo de inserción de lápiz del control InkEdit . El envío de este mensaje no tiene ningún efecto si se usa con cualquier sistema operativo instalado que no sea Microsoft Windows XP Tablet PC Edition.
Parámetros:
Wparam Especifica uno de los valores de la enumeración InkInsertMode , que especifica si la entrada de lápiz se inserta en el control como texto o como entrada de lápiz.
Lparam Este parámetro no se usa; debe ser 0.
Valores devueltos:
Este mensaje devuelve 0 si es correcto o distinto de cero si se produce un error.
EM_GETDRAWATTR
 Obtiene los atributos de dibujo actuales del control InkEdit .
Parámetros:
Wparam Este parámetro no se usa; debe ser 0.
Lparam Especifica un puntero (IInkDrawingAttributes **pDrawAttr) para recibir el objeto InkDrawingAttributes actual.
Valores devueltos:
Este mensaje devuelve 0 si es correcto o distinto de cero si se produce un error.
EM_SETDRAWATTR
 Establece los atributos de dibujo que se van a usar para futuras colecciones de lápiz.
Parámetros:
Wparam Este parámetro no se usa; debe ser 0.
Lparam Especifica un puntero (IInkDrawingAttributes *pDrawAttr) a un objeto InkDrawingAttributes .
Valores devueltos:
Este mensaje devuelve 0 si es correcto o distinto de cero si se produce un error.
EM_GETRECOTIMEOUT
 Obtiene el tiempo de espera de reconocimiento, en milisegundos, para el control InkEdit .
Parámetros:
Este mensaje no tiene parámetros; wParam y lParam deben ser 0.
Valores devueltos:
Este mensaje devuelve el tiempo de espera de reconocimiento, en milisegundos.
EM_SETRECOTIMEOUT
 Establece el tiempo de espera de reconocimiento, en milisegundos, para el control InkEdit .
Parámetros:
Wparam Especifica el tiempo de espera de reconocimiento, en milisegundos.
Lparam Este parámetro no se usa; debe ser 0.
Valores devueltos:
Este mensaje devuelve 0 si es correcto o distinto de cero si se produce un error.
EM_GETGESTURESTATUS
 Obtiene el estado del gesto del control InkEdit .
Parámetros:
Wparam Especifica el tipo de gesto, tal como se define en la enumeración InkApplicationGesture .
Lparam Este parámetro no se usa; debe ser 0.
Valores devueltos:
Este mensaje devuelve TRUE si el control InkEdit se suscribe al gesto o FALSE si el control InkEdit no se suscribe al gesto.
EM_SETGESTURESTATUS
 Establece el estado del gesto del control InkEdit .
Parámetros:
Wparam Especifica el tipo de gesto, tal como se define en la enumeración InkApplicationGesture .
Lparam Especifica TRUE si la suscripción al gesto está habilitada o FALSE si no está habilitada la escucha del gesto.
Valores devueltos:
Este mensaje devuelve 0 si es correcto o distinto de cero si se produce un error.
Comentarios:
Esto solo se debe usar si el EM_GETSTATUS devuelve IES_Idle.
EM_GETRECOGNIZER
 Obtiene el reconocedor que usa el control InkEdit .
Parámetros:
Wparam Este parámetro no se usa; debe ser 0.
Lparam Especifica un puntero a un IInkRecognizer* para recibir el objeto IInkRecognizer que usa el control InkEdit .
Valores devueltos:
Este mensaje devuelve 0 si es correcto o distinto de cero si se produce un error.
EM_SETRECOGNIZER
 Establece el reconocedor que usa el control InkEdit . Si se usa un Factoid para el control InkEdit, se debe volver a aplicar después de enviar este mensaje.
Parámetros:
Wparam Este parámetro no se usa; debe ser 0.
Lparam Especifica un puntero a un IInkRecognizer* para establecer el objeto IInkRecognizer que el control InkEdit usa para su uso posterior.
Valores devueltos:
Este mensaje devuelve 0 si es correcto o distinto de cero si se produce un error.
Comentarios:
Esto solo se debe usar si el EM_GETSTATUS devuelve IES_Idle.
EM_GETFACTOID
 Obtiene el Factoid que se va a usar para el reconocimiento.
Parámetros:
Wparam Este parámetro no se usa; debe ser 0.
Lparam Especifica un puntero a un BSTR para recibir la cadena factoid.
Valores devueltos:
Este mensaje devuelve 0 si es correcto o distinto de cero si se produce un error.
EM_SETFACTOID
 Establece el Factoid que se va a usar para el reconocimiento.
Parámetros:
Wparam Este parámetro no se usa; debe ser 0.
Lparam Especifica el BSTR que contiene la cadena factoid.
Valores devueltos:
Este mensaje devuelve 0 si es correcto o distinto de cero si se produce un error.
Comentarios:
Esto solo se debe usar si el EM_GETSTATUS devuelve IES_Idle.
EM_GETSELINK
 Obtiene la entrada de lápiz dentro de la selección. La entrada de lápiz debe reconocerse antes de tener acceso a través de este mensaje. Si no se reconoce en primer lugar, EM_GETSELINK siempre devuelve cero objetos InkDisp .
Parámetros:
Wparam Este parámetro no se usa; debe ser 0.
Lparam Especifica un puntero a un VARIANT para recibir una matriz segura para recibir objetos InkDisp dentro de la selección actual.
Valores devueltos:
Este mensaje devuelve 0 si es correcto o distinto de cero si se produce un error.
EM_SETSELINK
 Establece la entrada de lápiz dentro de la selección. El envío de este mensaje no tiene ningún efecto si se usa con cualquier sistema operativo instalado que no sea Windows XP Tablet PC Edition.
Parámetros:
Wparam Este parámetro no se usa; debe ser 0.
Lparam Especifica un puntero a un VARIANT con una matriz segura de objetos InkDisp para reemplazar la selección actual.
Valores devueltos:
Este mensaje devuelve 0 si es correcto o distinto de cero si se produce un error.
EM_GETSELINKDISPLAYMODE
 Devuelve la apariencia actual de la entrada de lápiz en el intervalo seleccionado mediante uno de los valores de la enumeración InkDisplayMode .
Parámetros:
Este mensaje no tiene parámetros; wParam y lParam deben ser 0.
Valores devueltos:
Este mensaje devuelve uno de los valores de la enumeración InkDisplayMode (IDM_Text o IDM_Ink), que especifica cómo aparece una selección en el control.
EM_SETSELINKDISPLAYMODE
 Establece la apariencia de la entrada de lápiz en el intervalo seleccionado mediante uno de los valores de la enumeración InkDisplayMode .
Parámetros:
Wparam Este parámetro no se usa; debe ser 0.
Lparam Especifica cómo aparece la entrada de lápiz en el intervalo seleccionado, tal como se define en la enumeración InkDisplayMode .
Valores devueltos:
Este mensaje devuelve 0 si es correcto o distinto de cero si se produce un error. El envío de este mensaje no tiene ningún efecto si se usa con cualquier sistema operativo instalado que no sea Windows XP Tablet PC Edition.
EM_GETSTATUS
 Obtiene el estado del control InkEdit .
Parámetros:
Este mensaje no tiene parámetros; wParam y lParam deben ser 0.
Valores devueltos:
Este mensaje devuelve uno de los valores de la enumeración InkEditStatus , que especifica si el control está inactivo, recopilando entrada de lápiz o reconociendo la entrada de lápiz.
EM_RECOGNIZE
 Fuerza el reconocimiento.
Parámetros:
Este mensaje no tiene parámetros; wParam y lParam deben ser 0.
Valores devueltos:
Este mensaje devuelve 0 si es correcto o distinto de cero si se produce un error.
EM_GETMOUSEICON
 Obtiene el icono del mouse.
Parámetros:
Wparam Este parámetro no se usa; debe ser 0.
Lparam Especifica un puntero HICON* que se rellena con el mouseIcon HICON actual. Este HICON puede ser un HICON o un valor NULL .
Valores devueltos:
Este mensaje devuelve 0 si es correcto o distinto de cero si se produce un error.
EM_SETMOUSEICON
 Establece el icono del mouse.
Parámetros:
Wparam Especifica un valor BOOLEAN que se establece en TRUE si el control InkEdit debe poseer el identificador HICON o FALSE si el control InkEdit no debe poseer el identificador HICON. Si el control InkEdit posee el HICON, entonces se encarga de y destruye el HICON adecuadamente. De lo contrario, el autor de la llamada posee el HICON y es responsable de eliminarlo.
Lparam Especifica el nuevo valor HICON. Use NULL para borrar el valor. El valor predeterminado es NULL.
Valores devueltos:
Este mensaje devuelve 0 si es correcto o distinto de cero si se produce un error.
EM_GETMOUSEPOINTER
 Obtiene el puntero del mouse.
Parámetros:
Wparam Este parámetro no se usa; debe ser 0.
Lparam Contiene un puntero InkMousePointer* que se rellena con el valor de MousePointer actual. Esto se comporta igual que la propiedad InkCollector::get_MousePointer .
Valores devueltos:
Este mensaje devuelve 0 si es correcto o distinto de cero si se produce un error.
EM_SETMOUSEPOINTER
 Establece el puntero del mouse.
Parámetros:
Wparam Este parámetro no se usa; debe ser 0.
Lparam Contiene el nuevo valor mousePointer , que se define en la enumeración InkMousePointer . Esto se comporta igual que la propiedad InkCollector::p ut_MousePointer .
Valores devueltos:
Este mensaje devuelve 0 si es correcto o distinto de cero si se produce un error.
EM_GETUSEMOUSEFORINPUT
 Obtiene el estado de si la entrada del mouse se trata como entrada de lápiz.
Parámetros:
Este mensaje no tiene parámetros; wParam y lParam deben ser 0.
Valores devueltos:
Este mensaje devuelve 0 si ES FALSE o 1 si ES TRUE.
EM_SETUSEMOUSEFORINPUT
 Establece el estado de si la entrada del mouse se trata como entrada de lápiz.
Parámetros:
Wparam Especifica un valor booleano que determina si se debe tratar la entrada del mouse como entrada de lápiz.
Lparam Este parámetro no se usa; debe ser 0.
Valores devueltos:
Este mensaje devuelve 0 si es correcto o distinto de cero si se produce un error.
Comentarios:
Esto solo debe usarse si el EM_GETSTATUS devuelve IES_Idle.
Mensaje de notificación de evento Descripción
IECN_STROKE
 Notifica a la ventana primaria del control InkEdit que se ha creado un IInkStrokeDisp . Esto se envía en un mensaje de WM_NOTIFY con los parámetros siguientes.
Parámetros:
Wparam Especifica el identificador del control que envió el mensaje.
Lparam Especifica un puntero a la estructura IEC_STROKEINFO .
Valores devueltos:
El cliente devuelve 0 para aceptar el trazo y 1 para cancelar el trazo.
IECN_GESTURE
 Notifica a la ventana primaria del control InkEdit que se ha reconocido un gesto. Esto se envía en un mensaje de WM_NOTIFY con los parámetros siguientes.
Parámetros:
Wparam Especifica el identificador del control que envió el mensaje.
Lparam Especifica un puntero a la estructura IEC_GESTUREINFO .
Valores devueltos:
El cliente devuelve 0 para aceptar el gesto y 1 para cancelar el gesto.
IECN_RECOGNITIONRESULT
 Notifica a la ventana primaria del control InkEdit que se ha producido el reconocimiento. Esto se envía en un mensaje de WM_NOTIFY con los parámetros siguientes.
Parámetros:
Wparam Especifica el identificador del control que envió el mensaje.
Lparam Especifica un puntero a la estructura IEC_RECOGNITIONRESULTINFO .
Valores devueltos:
El cliente devuelve 0 si procesa el mensaje.

Se aplica a

estructura de IEC_GESTUREINFO (solo Win32)

estructura de IEC_STROKEINFO (solo Win32)

estructura de IEC_RECOGNITIONRESULTINFO (solo Win32)

MousePointer (propiedad)

InkEditStatus (enumeración)

InkInsertMode (enumeración)

InkMode (enumeración)

IInkCursor (interfaz)

InkDrawingAttributes (clase)

IInkRecognitionResult (Interfaz)

IInkRecognizer (interfaz)

InkDisp (clase)

IInkGesture (interfaz)