Partilhar via

Função SetFlags (recapis.h)

Especifica como o reconhecedor interpreta a tinta e determina a cadeia de caracteres de resultado.

Chame essa função antes de processar a tinta pela primeira vez. Portanto, chame a função SetFlags antes de chamar a função Processo .

Sintaxe

HRESULT SetFlags(
  [in] HRECOCONTEXT hrc,
  [in] DWORD        dwFlags
);

Parâmetros

[in] hrc

Manipule para o contexto do reconhecedor.

[in] dwFlags

A tabela a seguir lista os sinalizadores que você pode definir para especificar como o reconhecedor interpreta a tinta e determina a cadeia de caracteres de resultado. Use o operador OR (|) para combinar sinalizadores conforme apropriado.

Sinalizador de bits Meaning
RECOFLAG_AUTOSPACE
 O Reconhecedor usa espaçamento inteligente com base em regras de modelo de linguagem.
RECOFLAG_COERCE
 O reconhecedor coagi o resultado com base no factóide especificado para o contexto. Por exemplo, se você especificar um factoid de número de telefone e o usuário inserir a palavra "olá", o reconhecedor poderá retornar um número de telefone aleatório ou uma cadeia de caracteres vazia. Se você não especificar esse sinalizador, o reconhecedor retornará "olá" como resultado.
RECOFLAG_PREFIXOK
 O Reconhecedor dá suporte ao reconhecimento de qualquer parte de prefixo das cadeias de caracteres definidas no modelo de linguagem padrão ou especificado (factoid).

Por exemplo, sem esse sinalizador, o usuário grava "handw" e o reconhecedor retorna sugestões (como "handed" ou "handed") que são palavras que existem no léxico do reconhecedor. Com o sinalizador, o reconhecedor pode retornar "handw" como uma das sugestões, pois é um prefixo válido da palavra "manuscrito" que existe no léxico do reconhecedor.

O Painel de Entrada do Tablet PC define esse sinalizador na maioria dos casos, exceto quando o escopo de entrada é IS_DEFAULT (ou nenhum escopo de entrada) ou quando não há nenhuma lista de palavras do usuário ou expressão regular.

Os reconhecedores de caracteres do Leste Asiático devem retornar E_INVALIDARG quando um chamador passar neste sinalizador.
RECOFLAG_LINEMODE
 O reconhecedor não divide linhas, mas ainda deve fazer a separação de caracteres e palavras. Isso é o mesmo que o modo alinhado, exceto que não há nenhum guia, e toda a tinta é considerada em uma única linha. Quando esse sinalizador é definido, um guia, se definido, é ignorado.
RECOFLAG_SINGLESEG
 Desabilita várias segmentações. Por padrão, o reconhecedor retorna várias segmentações (alternativas) para a tinta.

Por exemplo, se você escrever "juntos" como traços separados, o reconhecedor poderá segmentar a tinta como "para obtê-la", "reunir" ou "juntos". Defina esse sinalizador se você não precisar de várias segmentações da tinta ao consultar alternativas. Isso melhora o desempenho e reduz o uso de memória.
RECOFLAG_WORDMODE
 O reconhecedor trata a tinta como uma única palavra. Por exemplo, se o contexto contiver "para obtê-la", o reconhecedor retornará "juntos".

Valor de retorno

Essa função pode retornar um desses valores.

Valor HRESULT Description
S_OK
 Êxito.
E_INVALIDARG
 O sinalizador é 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_POINTER
 O contexto é inválido ou um dos parâmetros é um ponteiro inválido.

Observações

Antes do Microsoft Windows XP Tablet PC Edition Development Kit 1.7, o Painel de Entrada do Tablet PC realizava espaçamento inteligente. A partir do Tablet PC SDK 1.7, o Painel de Entrada continua a produzir resultados com recomendações preliminares de espaçamento. No entanto, os resultados do espaçamento do Painel de Entrada do Tablet PC podem ser alterados pelas recomendações do reconhecedor (resultados). O reconhecedor é capaz de fazer isso usando informações contextuais de texto (com base na chamada SetTextContext feita pelo Painel de Entrada) e suas regras de modelo de linguagem internas.

O Painel de Entrada é capaz de determinar se o reconhecedor é capaz de fazer o espaçamento automático chamando essa função com o sinalizador RECOFLAG_AUTOSPACE definido. Se o reconhecedor não der suporte ao espaçamento automático, E_INVALIDARG será retornado.

Nota Há suporte apenas para o modo de linha na função SetFlags . Não há suporte para modo boxed, modo gratuito e modo de linha única.
 

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

Consulte também

Função SetFactoid

Função SetTextContext

  • Last updated on