AddStroke-Funktion (recapis.h)

Artikel
11/06/2024

Fügt recognizerContext einen Freihandstrich hinzu.

Syntax

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

Parameter

hrc

Das Handle für den Erkennungskontext.

pPacketDesc

Beschreibt den Inhalt der Pakete. Die Beschreibung muss mit dem Inhalt der Pakete in pPacket übereinstimmen. Wenn NULL, verwendet diese Funktion die GetPreferredPacketDescription-Funktion .

cbPacket

Größe des pPacket-Puffers in Byte.

pPacket

Array von Paketen, die Tablet-Raumkoordinaten enthalten.

pXForm

Beschreibt die Transformation, die auf Freihand angewendet werden kann, um sie vom Tablet-Raum in den Freihandraum zu transformieren. Eine Erkennung kann diese Transformation ignorieren und eigene Freihandrotationsalgorithmen implementieren. Diese Erkennungen sollten weiterhin Eigenschaften zurückgeben, die in den Gitterdaten relativ zu dieser Transformation berechnet werden.

Rückgabewert

Diese Funktion kann einen dieser Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Erfolg.
E_POINTER	Einer der Parameter ist ein ungültiger Zeiger.
E_OUTOFMEMORY	Speicher kann nicht zugeordnet werden, um den Vorgang abzuschließen.
TPC_E_INVALID_PACKET_DESCRIPTION	Die Paketbeschreibung enthält nicht die erforderlichen Informationen, damit das Paket als gültig angesehen wird. Sie enthält beispielsweise keine GUID_X- oder GUID_Y-Eigenschaft.
TPC_E_OUT_OF_ORDER_CALL	Der Aufruf der -Methode erfolgte in der richtigen Reihenfolge.
E_FAIL	Es ist ein unbekannter Fehler aufgetreten.
E_INVALIDARG	Ein ungültiges Argument wurde empfangen.

Hinweise

Die Erkennung muss Eigenschaften wie Baseline in Freihandraumkoordinaten anstelle von Tabletkoordinaten zurückgeben.

Es wird empfohlen, die Anzahl der Striche pro Kontext und/oder die in einem bestimmten Strich zulässigen Punkte zu begrenzen. Beschränken Sie die Eingabe auf 1024 Striche pro Kontext und 32767 Punkte pro Strich.

Striche mit null Punkten sind nicht zulässig. In diesem Fall sollten Sie E_FAIL zurückgeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP Tablet PC Edition [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	recapis.h
DLL	inkobjcore.dll

Weitere Informationen

GetPreferredPacketDescription

PACKET_DESCRIPTION-Struktur

Freigeben über