Clase InkOverlay
Representa un objeto que resulta útil para escenarios de anotación en los que los usuarios no están interesados en realizar el reconocimiento en la entrada de lápiz, sino que están interesados en el tamaño, la forma, el color y la posición de la entrada de lápiz.
La creación del control InkOverlay detrás de un control transparente (por ejemplo, un GroupBox con el conjunto de propiedades WS_EX_TRANSPARENT) impedirá que InkOverlay recopile la entrada de lápiz.
InkOverlay tiene estos tipos de miembros:
Eventos
La clase InkOverlay tiene estos eventos.
| Evento | Descripción |
|---|---|
| CursorButtonDown | Se produce cuando InkOverlay detecta un botón de cursor que está inactivo. |
| CursorButtonUp | Se produce cuando InkOverlay detecta un botón de cursor que está activo. |
| CursorDown | Se produce cuando la punta del cursor se pone en contacto con la superficie de la tableta de digitalización. |
| CursorInRange | Se produce cuando un cursor entra en el intervalo de detección física (proximidad) del contexto de la tableta. |
| CursorOutOfRange | Se produce cuando el cursor deja el intervalo de detección física (proximidad) del contexto de la tableta. |
| Doubleclick | Se produce cuando se hace doble clic en el objeto InkOverlay . |
| Gesto | Se produce cuando se reconoce un gesto específico de la aplicación. |
| MouseDown | Se produce cuando el puntero del mouse está sobre el objeto InkOverlay y se presiona un botón del mouse. |
| MouseMove | Se produce cuando el puntero del mouse se mueve sobre el objeto InkOverlay . |
| MouseUp | Se produce cuando el puntero del mouse está sobre el objeto InkOverlay y se suelta un botón del mouse. |
| Mousewheel | Se produce cuando la rueda del mouse se mueve mientras el objeto InkOverlay tiene el foco. |
| NewInAirPackets | Se produce cuando se ve un paquete en el aire, que ocurre cuando un usuario mueve un lápiz cerca de la tableta y el cursor está dentro de la ventana del objeto InkOverlay o el usuario mueve un mouse dentro de la ventana asociada del objeto InkOverlay . |
| NewPackets | Se produce cuando el objeto InkOverlay recibe paquetes. |
| Pintado | Se produce cuando el objeto InkOverlay se ha completado para volver a dibujarse. |
| Representación | Se produce antes de que el objeto InkOverlay se vuelva a dibujar. |
| SelectionChanged | Se produce cuando la selección de entrada de lápiz dentro del control ha cambiado, como a través de modificaciones en la interfaz de usuario, procedimientos de corte y pegado, o la propiedad Selection . |
| SelectionChanging | Se produce cuando la selección de entrada de lápiz dentro del control está a punto de cambiar, como a través de modificaciones en la interfaz de usuario, procedimientos de corte y pegado, o la propiedad Selection . |
| SelectionMoved | Se produce cuando la posición de la selección actual ha cambiado, como a través de modificaciones en la interfaz de usuario, procedimientos de corte y pegado, o la propiedad Selection . |
| SelectionMoving | Se produce cuando la posición de la selección actual está a punto de cambiar, como a través de modificaciones en la interfaz de usuario, procedimientos de corte y pegado, o la propiedad Selection . |
| SelectionResized | Se produce cuando el tamaño de la selección actual ha cambiado, como a través de modificaciones en la interfaz de usuario, procedimientos de corte y pegado, o la propiedad Selection . |
| SelectionResizing | Se produce cuando el tamaño de la selección actual está a punto de cambiar, como a través de modificaciones en la interfaz de usuario, procedimientos de corte y pegado o la propiedad Selection . |
| Carrera | Se produce cuando el usuario termina de dibujar un nuevo trazo en cualquier tableta. |
| StrokesDeleted | Se produce después de que los trazos se hayan eliminado de la propiedad Ink . |
| StrokesDeleting | Se produce antes de que los trazos se eliminen de la propiedad Ink . |
| SystemGesture | Se produce cuando se reconoce un gesto del sistema. |
| TabletAdded | Se produce cuando se agrega un IInkTablet al sistema. |
| TabletRemoved | Se produce cuando se quita una tableta del sistema. |
Interfaces
La clase InkOverlay define estas interfaces.
| Interfaz | Descripción |
|---|---|
| IInkOverlay | Este objeto implementa la interfaz COM IInkOverlay . |
Métodos
La clase InkOverlay tiene estos métodos.
| Método | Descripción |
|---|---|
| Dibujar | Establece un rectángulo en el que se va a volver a dibujar la entrada de lápiz dentro del objeto InkOverlay . |
| GetEventInterest | Devuelve el estado actual de un evento de objeto InkOverlay determinado, es decir, si el evento se escucha o se usa. |
| GetGestureStatus | Devuelve si el objeto InkOverlay está interesado en un gesto determinado. |
| GetWindowInputRectangle | Recupera el rectángulo de ventana, en píxeles, dentro del cual se dibuja la entrada de lápiz. |
| HitTestSelection | Determina qué parte de la selección se alcanzó durante una prueba de posicionamiento. |
| SetAllTabletsMode | Este modo permite que el objeto InkOverlay recopile tinta de cualquier tableta conectada al pc tablet. |
| SetEventInterest | Establece si se debe escuchar o usar un evento específico. |
| SetGestureStatus | Establece el interés del objeto InkOverlay en un gesto conocido. |
| SetSingleTabletIntegratedMode | Este modo permite que el objeto InkOverlay recopile tinta de solo una tableta. El objeto InkOverlay omite la entrada de lápiz de otras tabletas. |
| SetWindowInputRectangle | Establece el rectángulo de ventana, en píxeles, que se va a usar para asignar tinta dibujada a la ventana. |
Propiedades
La clase InkOverlay tiene estas propiedades.
| Propiedad | Tipo de acceso | Descripción |
|---|---|---|
|
AttachMode |
Lectura/escritura |
Obtiene o establece el valor que especifica si el objeto InkOverlay se adjunta detrás o delante de la ventana conocida. |
|
AutoRedraw |
Lectura/escritura |
Obtiene o establece un valor que especifica si InkOverlay vuelve a pintar la entrada de lápiz cuando se invalida la ventana. |
|
CollectingInk |
Solo lectura |
Obtiene un valor que especifica si la entrada de lápiz se está dibujando actualmente en un objeto InkOverlay . |
|
CollectionMode |
Lectura/escritura |
Obtiene o establece el modo de colección que determina si la entrada de lápiz, los gestos o ambos se reconocen como escribe el usuario. |
|
Cursores |
Solo lectura |
Obtiene la colección Cursors que está disponible para su uso en la región de entrada manuscrita . |
|
DefaultDrawingAttributes |
Lectura/escritura |
Obtiene o establece el objeto InkDrawingAttributes predeterminado, que especifica los atributos de dibujo que se usan al dibujar y mostrar la entrada de lápiz. |
|
DesiredPacketDescription |
Lectura/escritura |
Obtiene o establece el interés en aspectos del paquete asociado a la entrada de lápiz dibujada en el objeto InkOverlay . |
|
DynamicRendering |
Lectura/escritura |
Obtiene o establece un valor que indica si la entrada de lápiz se representa a medida que se dibuja. |
|
EditingMode |
Lectura/escritura |
Obtiene o establece un valor que indica si InkOverlay está en modo de entrada de lápiz, modo de eliminación o selección o modo de edición. |
|
habilitado |
Lectura/escritura |
Obtiene o establece un valor que especifica si el objeto InkOverlay recopila la entrada del lápiz. |
|
EraserMode |
Lectura/escritura |
Obtiene o establece un valor que indica si la entrada de lápiz se borra por trazo o por punto. |
|
EraserWidth |
Lectura/escritura |
Obtiene o establece un valor que especifica el ancho de la punta del lápiz del borrador. |
|
Handle |
Lectura/escritura |
Obtiene o establece el identificador de la ventana a la que se adjunta el objeto InkOverlay . |
|
Entrada de lápiz |
Lectura/escritura |
Obtiene o establece el objeto InkDisp asociado al objeto InkOverlay . |
|
MarginX |
Lectura/escritura |
Obtiene o establece los márgenes a lo largo del eje X, en píxeles. |
|
MarginY |
Lectura/escritura |
Obtiene o establece los márgenes a lo largo del eje y, en píxeles. |
|
MouseIcon |
Lectura/escritura |
Obtiene o establece el icono del mouse personalizado actual. |
|
Mousepointer |
Lectura/escritura |
Obtiene o establece un valor que indica el tipo de puntero del mouse que aparece cuando el mouse está sobre una parte determinada del objeto. |
|
Representador |
Lectura/escritura |
Obtiene o establece el objeto InkRenderer que se usa para dibujar la entrada de lápiz. |
|
Número de selección |
Lectura/escritura |
Obtiene o establece la colección InkStrokes que está seleccionada actualmente dentro del control InkOverlay . |
|
SupportHighContrastInk |
Lectura/escritura |
Obtiene o establece un valor que especifica si la entrada de lápiz se representa como un solo color cuando el sistema está en modo de contraste alto. |
|
SupportHighContrastSelectionUI |
Lectura/escritura |
Obtiene o establece un valor que especifica si toda la interfaz de usuario de selección se dibuja en contraste alto cuando el sistema está en modo de contraste alto. |
|
Tablet |
Solo lectura |
Obtiene el dispositivo de tableta que el objeto InkOverlay usa actualmente para recopilar la entrada. |
Notas de implementación de MFC
Si adjuntó el objeto InkOverlay a un objeto CView, libere el objeto InkOverlay en respuesta al mensaje de WM_DESTROY como se muestra en el ejemplo siguiente:
BOOL CRecognitionAlternatesSampleCppView::OnWndMsg(UINT msg, WPARAM wp, PARAM lp, LRESULT *pLR)
{
if(WM_DESTROY == msg)
m_spInkOverlay.Release();
return CView::OnWndMsg(msg, wp, lp, pLR);
}
Observaciones
Este objeto se puede crear una instancia llamando al método CoCreateInstance en C++.
El objeto InkOverlay es adecuado para tomar notas y escribir en el lápiz básico. El uso previsto principal de este objeto es mostrar la entrada de lápiz como entrada de lápiz.
En general, la interfaz de usuario en tiempo de ejecución de este objeto es una ventana transparente con tinta opaca.
Los eventos MouseDown, MouseMove, MouseUp y MouseWheel devuelven coordenadas x e coordenadas Y en píxeles, y no las unidades HIMETRIC asociadas al espacio de entrada de lápiz. Esto se debe a que estos eventos reemplazan los eventos del mouse de las aplicaciones no compatibles con el lápiz y estas aplicaciones solo comprenden píxeles.
Precaución
Si va a establecer la propiedad AttachMode del objeto InkOverlay en InFront, cree el objeto InkOverlay en el subproceso en el que se ejecuta el formulario. La aplicación puede dejar de responder si el objeto InkOverlay se crea en un subproceso diferente y su propiedad AttachMode se establece en InFront.
Nota
El objeto InkOverlay no se puede liberar de forma segura en un subproceso que no sea de interfaz de usuario.
Para mejorar el rendimiento de la aplicación, elimine el objeto InkOverlay cuando ya no sea necesario.
Si adjuntó el objeto InkOverlay a un objeto CView, libere el objeto InkOverlay en respuesta al mensaje de WM_DESTROY como se muestra en el ejemplo siguiente:
BOOL CRecognitionAlternatesSampleCppView::OnWndMsg(UINT msg, WPARAM wp, PARAM lp, LRESULT *pLR)
{
if(WM_DESTROY == msg)
m_spInkOverlay.Release();
return CView::OnWndMsg(msg, wp, lp, pLR);
}
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows XP Tablet PC Edition [solo aplicaciones de escritorio] |
| Servidor mínimo compatible |
No se admite ninguno |
| Encabezado |
|
| Biblioteca |
|