AddStroke-Funktion (recapis.h)

  • Artikel

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