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

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 Significado
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 factoid especificado para o contexto. Por exemplo, se você especificar um factoid de número de telefone e o usuário inserir a palavra "hello", 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á "hello" 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 nesse 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 forrado, exceto que não há 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".

Retornar valor

Essa função pode retornar um desses valores.

Valor HRESULT Descrição
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
Ocorreu um erro não especificado.
E_POINTER
O contexto é inválido ou um dos parâmetros é um ponteiro inválido.

Comentários

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 SDK do Tablet PC 1.7, o Painel de Entrada continua a produzir resultados com recomendações preliminares de espaçamento. No entanto, os resultados de 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.
 

Requisitos

Requisito Valor
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

Confira também

Função SetFactoid

Função SetTextContext