Clase InkOverlay

Artículo
06/13/2023

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
Interfaces
Métodos
Propiedades

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.