Funzione AdviseInkChange (recapis.h)

  • Articolo

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