Partilhar via


Função SetTextContext (recapis.h)

Fornece as cadeias de caracteres de texto que vêm antes e depois do texto contido no contexto do reconhecedor.

Você chama essa função antes de processar a tinta pela primeira vez. Portanto, chame a função SetTextContext antes de chamar a função Process .

Sintaxe

HRESULT SetTextContext(
  HRECOCONTEXT hrc,
  ULONG        cwcBefore,
  const WCHAR  *pwcBefore,
  ULONG        cwcAfter,
  const WCHAR  *pwcAfter
);

Parâmetros

hrc

Manipule para o contexto do reconhecedor.

cwcBefore

Número de caracteres em pwcBefore.

pwcBefore

Cadeia de caracteres de texto que vem antes do texto contido no contexto do reconhecedor. A cadeia de caracteres não é terminada NULL .

cwcAfter

Número de caracteres em pwcAfter.

pwcAfter

Cadeia de caracteres de texto que vem após o texto contido no contexto do reconhecedor. A cadeia de caracteres não é NULL -terminated.

Valor de retorno

Essa função pode retornar um desses valores.

Código de retorno Description
S_OK
Êxito.
E_POINTER
O contexto é inválido ou um dos parâmetros é um ponteiro inválido.
E_NOTIMPL
O reconhecedor não dá suporte a essa função.
E_OUTOFMEMORY
Não é possível alocar memória para concluir a operação.
E_FAIL
Erro não especificado.
E_INVALIDARG
Um argumento inválido foi especificado.

Observações

A função SetTextContext fornece contexto para uma frase ou uma palavra, aumentando a precisão do reconhecedor. Por exemplo, se a cadeia de caracteres pwcBeforepwcBefore for "under the" e a cadeia de caracteres pwcAfter estiver "na casa", você poderá influenciar seu reconhecedor usando uma palavra ou palavras entre as cadeias de caracteres. O reconhecedor deve considerar o espaço após "o" e antes de "entrar" ao executar o reconhecimento.

No entanto, se a cadeia de caracteres pwcAfter for "Hel" e a cadeia de caracteres pwcBefore for "o", a falta de espaço entre as cadeias de caracteres indicará que o reconhecedor deve reconhecer uma ou mais letras dentro de uma palavra que começa com "Hel" e termina com "o".

É recomendável limitar o comprimento do contexto de texto a no máximo 1.024 caracteres para os contextos esquerdo e direito.

Requirements

Requirement Value
Cliente mínimo suportado Windows XP Tablet PC Edition [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo compatível Nenhum compatível
da Plataforma de Destino Windows
Header recapis.h
Library inkobjcore.lib
de DLL inkobjcore.dll