Funzione SetGuide (recapis.h)

Articolo
04/09/2023

Imposta la guida al riconoscimento da usare per l'input boxed o allineato. Prima di aggiungere tratti al contesto, è necessario chiamare questa funzione.

Sintassi

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

Parametri

hrc

Gestire il contesto del riconoscimento.

pGuide

Guida all'uso per l'input della casella o della riga. L'impostazione di questo parametro su NULL significa che il contesto non ha alcuna guida. Si tratta dell'impostazione predefinita e significa che il riconoscimento è in modalità di input libero. Per informazioni dettagliate sulla guida, vedere la struttura RECO_GUIDE .

iIndex

Valore di indice da usare per la prima casella o riga nel contesto.

Valore restituito

Questa funzione può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Operazione completata.
E_POINTER	Il contesto non è valido o uno dei parametri è un puntatore non valido.
E_OUTOFMEMORY	Impossibile allocare memoria per completare l'operazione.
E_INVALIDARG	Si è tentato di impostare una modalità di riconoscimento (libera, allineata, casellata e così via) non supportata dal riconoscimento o i valori di campo RECO_GUIDE sono illegali (altezze negative o larghezze, ad esempio).
E_FAIL	Si è verificato un errore non specificato.
TPC_E_OUT_OF_ORDER_CALL	Si è tentato di impostare la guida quando è già presente un input penna nel contesto reco o, nel caso dei riconoscimento dei caratteri asiatici orientali, SetCACMode è stato chiamato in precedenza.

Commenti

Le caselle guida sono numerate in base al valore iIntex .

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP Tablet PC Edition [app desktop \| App UWP]
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	recapis.h
DLL	inkobjcore.dll

Vedi anche

Funzione GetGuide

Struttura RECO_GUIDE

Condividi tramite