Mensajes InkEdit (solo Win32)
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++ |
---|
|
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. |