Função SetGuide (recapis.h)

Define o guia de reconhecimento a ser usado para entradas em caixa ou forradas. 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 guia. Esse é o padrão e significa que o reconhecedor está no modo de entrada gratuita. Para obter detalhes do guia, consulte a estrutura RECO_GUIDE .

iIndex

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

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_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 é compatível com o reconhecedor ou os valores de campo RECO_GUIDE são ilegais (alturas ou larguras negativas, por exemplo).
E_FAIL	Ocorreu um erro não especificado.
TPC_E_OUT_OF_ORDER_CALL	Tentativa de definir o guia quando já havia alguma tinta no contexto reco ou, no caso de reconhecedores de caracteres do Leste Asiático, SetCACMode foi chamado anteriormente.

Comentários

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

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 GetGuide

Estrutura RECO_GUIDE