Compartilhar via

Função SetGuide (recapis.h)

Define o guia de reconhecimento a ser usado para entrada em caixa ou forrada. Você deve chamar essa função antes de adicionar traços ao contexto.

Sintaxe

HRESULT SetGuide(
  HRECOCONTEXT     hrc,
  const RECO_GUIDE *pGuide,
  ULONG            iIndex
);

Parâmetros

hrc

Manipule para o contexto do reconhecedor.

pGuide

Guia a ser usado para entrada de caixa ou linha. Definir esse parâmetro como NULL significa que o contexto não tem nenhum guia. Esse é o padrão e significa que o reconhecedor está no modo de entrada gratuita. Para obter detalhes do guia, consulte a estrutura de RECO_GUIDE .

iIndex

Valor de índice a ser usado para a primeira caixa ou linha no contexto.

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_OUTOFMEMORY
 Não é possível alocar memória para concluir a operação.
E_INVALIDARG
 Tentativa de definir um modo de reconhecimento (gratuito, forrado, em caixa e assim por diante) que não é suportado pelo reconhecedor ou os valores de campo RECO_GUIDE são ilegais (alturas ou larguras negativas, por exemplo).
E_FAIL
 Erro não especificado.
TPC_E_OUT_OF_ORDER_CALL
 Tentou definir o guia quando já havia alguma tinta no contexto de reco ou, no caso de reconhecedores de caracteres do Leste Asiático, SetCACMode foi chamado anteriormente.

Observações

As caixas de guia são numeradas com base no valor iIntex .

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 GetGuide

Estrutura RECO_GUIDE

  • Last updated on