Funzione AdviseInkChange (recapis.h)

Articolo
03/05/2024

Arresta l'elaborazione dell'input penna perché è stato aggiunto o eliminato un tratto.

Sintassi

HRESULT AdviseInkChange(
  HRECOCONTEXT hrc,
  BOOL         bNewStroke
);

Parametri

hrc

Handle nel contesto del riconoscimento.

bNewStroke

TRUE se si aggiunge un nuovo tratto. Impostare su FALSE se i tratti sono stati cancellati, suddivisi, uniti, estratti o eliminati dall'oggetto Input penna.

Valore restituito

Questa funzione può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Operazione completata. Questa funzione restituisce anche S_OK se il riconoscimento non supporta questa funzione.
E_POINTER	Uno dei parametri è un puntatore non valido.
E_FAIL	Si è verificato un errore non specificato.
E_INVALIDARG	È stato ricevuto un argomento non valido.

Commenti

La funzione AdviseInkChange segnala che saranno presenti chiamate aggiuntive alla funzione AddStroke . Ciò consente a qualsiasi riconoscimento già in corso di arrestarsi in qualsiasi punto pratico. Il completamento del riconoscimento è un punto di questo tipo, quindi AdviseInkChange può fare nulla in modo sicuro.

Ad esempio, se si hanno due thread, un thread può usare AddStroke e Process con altre funzioni per ottenere risultati. L'altro thread può raccogliere input penna, richiamarlo e accodare le attività per il primo thread. Il secondo thread chiama AdviseInkChange per notificare al riconoscimento una modifica. Ciò consente al primo thread di tornare al chiamante prima che senza la chiamata a AdviseInkChange. Il primo thread può quindi chiamare di nuovo il riconoscimento con più input penna.

Se si imposta il parametro bNewStroke su FALSE perché un tratto è stato modificato o eliminato, è necessario chiamare anche la funzione ResetContext e quindi chiamare la funzione AddStroke per aggiungere i tratti dall'oggetto InkDisp al contesto di riconoscimento. Questa operazione viene eseguita automaticamente se si collega il contesto del riconoscimento all'oggetto InkDisp .

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

Condividi tramite