cabeçalho shellhandwriting.h

Habilita a escrita à tinta com uma caneta ativada ou próxima a qualquer controle de edição de texto sem primeiro definir o foco para o controle. O sistema determina a intenção, identifica um destino de entrada, renderiza os traços de tinta, reconhece a tinta como texto (ou um gesto para modificar o texto), sugere candidatos a texto quando disponível e insere o texto novo ou modificado no campo de edição do controle.

Esse cabeçalho é usado pela entrada ink. Para obter mais informações, consulte:

• Entrada à tinta

O TSF (Text Services Framework) e o UIA (Automação da Interface do Usuário) são usados para dar suporte à funcionalidade ShellHandwriting.

As etapas a seguir descrevem o processo básico usado para a funcionalidade ShellHandwriting.

1. Determinação de recusa: Determine se o aplicativo dá suporte a ShellHandwriting. Normalmente, aplicativos que não têm implementações robustas de Automação da Interface do Usuário (UIA) ou aqueles com manipulação de tinta personalizada.
2. Determinação da intenção: Se o aplicativo der suporte a ShellHandwriting, o sistema determinará se a entrada do ponteiro para baixo da caneta deve ser passada para o aplicativo ou usada para manuscrito.
3. Determinação do toque: Se a entrada de caneta deve ser usada para manuscrito, teste se a entrada foi recebida por um controle acionável (como um botão, que teria precedência de entrada) e se um controle capaz de receber texto (tipos Editar, ComboBox ou Documento) pode ser encontrado habilitado, não somente leitura e capaz de aceitar o foco do teclado.
4. Determinação de destino: Se a entrada puder ser usada para manuscrito, uma caixa delimitadora será criada em torno de uma parte da entrada para determinar o controle de edição mais adequado para receber os resultados de reconhecimento de tinta (determinação de destino).
5. Determinação final: Quando um controle de edição de destino é identificado e dado o foco, vários outros indicadores de contexto (como escopo de entrada, idioma, rects delimitação de texto existentes) são usados para confirmar a adequação antes que os resultados do reconhecimento de tinta sejam copiados para o controle.

shellhandwriting.h contém as seguintes interfaces de programação:

Interfaces

IHandwritingInputRoutingCallback Fornece suporte ao roteamento de entrada para separar o thread do sistema de tratamento de entrada da caneta do thread da interface do usuário do destino de entrada.
ITfDetermineProximateHandwritingTargetArgs Fornece comportamento de resposta de manuscrito e informações de destino próximas.
ITfFocusHandwritingTargetArgs Fornece o comportamento de resposta de manuscrito e as informações de destino.
ITfHandwriting Dá suporte à entrada à tinta com uma caneta em qualquer campo de edição próximo sem primeiro ter que definir o foco para o controle de edição. Os traços de tinta são renderizados, o reconhecimento de manuscrito é executado (como texto ou gesto de edição) e o texto é inserido no campo de edição.
ITfHandwritingRequest Os aplicativos devem usar essa interface para notificar o sistema de que eles avaliaram a entrada da caneta que ocorreu após a solicitação de manuscrito.
ITfHandwritingSink Dá suporte à capacidade de especificar comportamentos de manuscrito personalizados antes que o foco seja definido como um campo de edição.

Funções

GetHandwritingStrokeIdForPointer Recupera a ID exclusiva do traço de tinta associado à ID do ponteiro especificada.
RegisterHandwritingInputRoutingCallback

Enumerações

TfHandwritingFocusTargetResponse Especifica como um cliente que implementa a interface IHandwritingInputRoutingCallback responde quando a função FocusHandwritingTarget é chamada.
TfHandwritingState Especifica como o manuscrito é tratado pelo sistema.
TfInputEvaluation Especifica como a entrada da caneta deve ser reconhecida.
TfProximateHandwritingTargetResponse Especifica os comportamentos de manuscrito com suporte com base no local próximo de um objeto de destino de manuscrito.