Compartir a través de


encabezado shellhandwriting.h

Habilita la entrada manuscrita con un lápiz activado o cerca de cualquier control de edición de texto sin establecer primero el foco en el control. El sistema determina la intención, identifica un destino de entrada, representa los trazos de lápiz, reconoce la entrada de lápiz como texto (o un gesto para modificar texto), sugiere candidatos de texto cuando estén disponibles e inserta el texto nuevo o modificado en el campo de edición del control.

La entrada ink usa este encabezado. Para más información, consulte:

Tanto Text Services Framework (TSF) como Automatización de la interfaz de usuario (UIA) se usan para admitir la funcionalidad ShellHandwriting.

En los pasos siguientes se describe el proceso básico que se usa para la funcionalidad shellHandwriting.

  1. Determinación de exclusión: Determine si la aplicación admite ShellHandwriting. Normalmente, las aplicaciones que no tienen implementaciones sólidas de Automatización de la interfaz de usuario (UIA) o aquellas con control de entrada de lápiz personalizado.
  2. Determinación de la intención: Si la aplicación admite ShellHandwriting, el sistema determina si la entrada del puntero de lápiz hacia abajo debe pasarse a la aplicación o usarse para escribir a mano.
  3. Determinación de pulsación: Si se debe usar la entrada del lápiz para la escritura a mano, compruebe si un control accionable recibió la entrada (por ejemplo, un botón, que tendría prioridad de entrada) y si un control capaz de recibir texto (tipos edit, ComboBox o Document) se puede encontrar que está habilitado, no es de solo lectura y puede aceptar el foco del teclado.
  4. Determinación de destino: Si se puede usar la entrada para la escritura a mano, se crea un rectángulo de selección alrededor de una parte de la entrada para determinar el control de edición más adecuado para recibir los resultados del reconocimiento de entrada de lápiz (determinación de destino).
  5. Determinación final: Cuando se identifica un control de edición de destino y se le asigna el foco, se usan otros indicadores de contexto (como el ámbito de entrada, el idioma, los rects de límite de texto existentes) para confirmar la idoneidad antes de que los resultados del reconocimiento de tinta se copien en el control.

shellhandwriting.h contiene las siguientes interfaces de programación:

Interfaces

 
IHandwritingInputRoutingCallback

Proporciona compatibilidad con el enrutamiento de entrada para separar el subproceso del sistema de control de entrada del lápiz del subproceso de interfaz de usuario del destino de entrada.
ITfDetermineProximateHandwritingTargetArgs

Proporciona el comportamiento de respuesta de escritura a mano y la información de destino de proxy.
ITfFocusHandwritingTargetArgs

Proporciona información de destino y comportamiento de respuesta de escritura a mano.
ITfHandwriting

Admite la entrada de lápiz con un lápiz en cualquier campo de edición de proxy sin tener que establecer el foco en el control de edición. Los trazos de lápiz se representan, el reconocimiento de escritura a mano se realiza (como texto o gesto de edición) y el texto se escribe en el campo de edición.
ITfHandwritingRequest

Las aplicaciones deben usar esta interfaz para notificar al sistema que han evaluado la entrada del lápiz que se produjo después de la solicitud de escritura a mano.
ITfHandwritingSink

Admite la capacidad de especificar comportamientos de escritura a mano personalizados antes de establecer el foco en un campo de edición.

Functions

 
GetHandwritingStrokeIdForPointer

Recupera el identificador único del trazo de lápiz asociado al identificador de puntero especificado.
RegisterHandwritingInputRoutingCallback

Enumeraciones

 
TfHandwritingFocusTargetResponse

Especifica cómo responde un cliente que implementa la interfaz IHandwritingInputRoutingCallback cuando se llama a la función FocusHandwritingTarget.
TfHandwritingState

Especifica cómo controla el sistema la escritura a mano.
TfInputEvaluation

Especifica cómo se debe reconocer la entrada del lápiz.
TfProximateHandwritingTargetResponse

Especifica los comportamientos de escritura a mano admitidos en función de la ubicación de proxy de un objeto de destino de escritura a mano.