Compartilhar 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 em 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.

Retornar valor

Essa função pode retornar um desses valores.

Código de retorno Descrição
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
Ocorreu um erro não especificado.
E_INVALIDARG
Um argumento inválido foi especificado.

Comentários

A função SetTextContext fornece contexto para uma frase ou palavra, aumentando a precisão do reconhecedor. Por exemplo, se a cadeia de caracteres pwcBeforepwcBefore estiver "sob o " 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 "in" 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 não mais do que 1024 caracteres cada um para os contextos esquerdo e direito.

Requisitos

   
Cliente mínimo com suporte Windows XP Tablet PC Edition [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Nenhum compatível
Plataforma de Destino Windows
Cabeçalho recapis.h
DLL inkobjcore.dll