Freigeben über

AddStroke-Funktion (recapis.h)

Fügt dem RecognizerContext einen Freihandstrich hinzu.

Syntax

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

Die 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 Bytes.

pPacket

Array von Paketen, die Tablet-Raumkoordinaten enthalten.

pXForm

Beschreibt die Transformation, die auf Freihand angewendet werden kann, um sie von Tablet-Raum in Freihandraum zu transformieren. Eine Erkennung kann diese Transformation ignorieren und ihre eigenen Freihanddrehungsalgorithmen 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 Description
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 betrachtet wird. Sie enthält beispielsweise keine GUID_X- oder GUID_Y-Eigenschaft.
TPC_E_OUT_OF_ORDER_CALL
 Der Aufruf der Methode wurde außerhalb der Reihenfolge ausgeführt.
E_FAIL
 Ein nicht angegebener Fehler ist aufgetreten.
E_INVALIDARG
 Ein ungültiges Argument wurde empfangen.

Bemerkungen

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

Es wird empfohlen, dass die Erkennung einen Grenzwert für die Anzahl der Striche pro Kontext und/oder die in einem bestimmten Strich zulässigen Punkte platziert. Beschränken Sie die Eingabe auf 1024 Striche pro Kontext und 32767 Punkt pro Strich.

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

Anforderungen

Anforderung Wert
Mindestens unterstützter Client Windows XP Tablet PC Edition [Desktop-Apps | UWP-Apps]
Mindestanforderungen für unterstützte Server Nicht unterstützt
Zielplattform Fenster
Header recapis.h
Library inkobjcore.lib
DLL inkobjcore.dll

Siehe auch

GetPreferredPacketDescription

PACKET_DESCRIPTION Struktur

  • Last updated on