AddStroke-Funktion (recapis.h)
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 |
|---|---|
|
Erfolg. |
|
Einer der Parameter ist ein ungültiger Zeiger. |
|
Speicher kann nicht zugeordnet werden, um den Vorgang abzuschließen. |
|
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. |
|
Der Aufruf der -Methode erfolgte in der richtigen Reihenfolge. |
|
Es ist ein unbekannter Fehler aufgetreten. |
|
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 |