Funzione AddStroke (recapis.h)

Articolo
11/06/2024

Aggiunge un tratto input penna a RecognizerContext.

Sintassi

HRESULT AddStroke(
  HRECOCONTEXT             hrc,
  const PACKET_DESCRIPTION *pPacketDesc,
  ULONG                    cbPacket,
  const BYTE               *pPacket,
  const XFORM              *pXForm
);

Parametri

hrc

Handle per il contesto del riconoscitore.

pPacketDesc

Descrive il contenuto dei pacchetti. La descrizione deve corrispondere al contenuto dei pacchetti in pPacket. Se NULL, questa funzione usa la funzione GetPreferredPacketDescription .

cbPacket

Dimensioni, in byte, del buffer pPacket .

pPacket

Matrice di pacchetti che contengono coordinate dello spazio tablet.

pXForm

Descrive la trasformazione che può essere applicata all'input penna per trasformarla dallo spazio tablet nello spazio input penna. Un riconoscitore può scegliere di ignorare questa trasformazione e implementare i propri algoritmi di rotazione dell'input penna. Questi riconoscitori devono comunque restituire proprietà calcolate nei dati del reticolo rispetto a questa trasformazione.

Valore restituito

Questa funzione può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Operazione completata.
E_POINTER	Uno dei parametri è un puntatore non valido.
E_OUTOFMEMORY	Impossibile allocare memoria per completare l'operazione.
TPC_E_INVALID_PACKET_DESCRIPTION	La descrizione del pacchetto non contiene le informazioni necessarie per il pacchetto da considerare valide. Ad esempio, non include una proprietà GUID_X o GUID_Y.
TPC_E_OUT_OF_ORDER_CALL	La chiamata al metodo è stata eseguita in ordine.
E_FAIL	Si è verificato un errore non specificato.
E_INVALIDARG	È stato ricevuto un argomento non valido.

Commenti

Il riconoscitore deve restituire proprietà come le coordinate dello spazio input penna di base anziché le coordinate del tablet.

È consigliabile che il riconoscitore inserisca un limite al numero di tratti per contesto e/o ai punti consentiti in un determinato tratto. Limitare l'input a 1024 tratti per contesto e 32767 punti per tratto.

I tratti con zero punti non sono consentiti. È consigliabile restituire E_FAIL in tal caso.

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

GetPreferredPacketDescription

Struttura PACKET_DESCRIPTION

Condividi tramite