AdviseInkChange-Funktion (recapis.h)

Hindert die Erkennung an der Verarbeitung von Freihand, da ein Strich hinzugefügt oder gelöscht wurde.

Syntax

HRESULT AdviseInkChange(
  HRECOCONTEXT hrc,
  BOOL         bNewStroke
);

Parameter

hrc

Das Handle für den Erkennungskontext.

bNewStroke

TRUE , wenn ein neuer Strich hinzugefügt wird. Legen Sie auf FALSE fest, wenn Striche gelöscht, geteilt, zusammengeführt, extrahiert oder aus dem Freihandobjekt gelöscht wurden.

Rückgabewert

Diese Funktion kann einen dieser Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Erfolg. Diese Funktion gibt auch S_OK zurück, wenn die Erkennung diese Funktion nicht unterstützt.
E_POINTER	Einer der Parameter ist ein ungültiger Zeiger.
E_FAIL	Es ist ein unbekannter Fehler aufgetreten.
E_INVALIDARG	Es wurde ein ungültiges Argument empfangen.

Hinweise

Die AdviseInkChange-Funktion signalisiert, dass zusätzliche Aufrufe der AddStroke-Funktion ausgeführt werden. Dadurch kann jede bereits laufende Erkennung an jedem geeigneten Punkt beendet werden. Der Abschluss der Erkennung ist ein solcher Punkt, sodass AdviseInkChange sicher nichts tun kann.

Wenn Sie beispielsweise über zwei Threads verfügen, kann ein Thread AddStroke und Process mit anderen Funktionen verwenden, um Ergebnisse zu erhalten. Der andere Thread sammelt möglicherweise Freihand, echot sie und Warteschlangenaufgaben für den ersten Thread. Der zweite Thread ruft AdviseInkChange auf, um die Erkennung über eine Bevorstehende Änderung zu benachrichtigen. Dadurch kann der erste Thread früher zum Aufrufer zurückkehren als ohne den Aufruf von AdviseInkChange. Der erste Thread kann dann die Erkennung wieder mit mehr Freihand aufrufen.

Wenn Sie den bNewStroke-Parameter auf FALSE festlegen, weil eine Striche geändert oder gelöscht wurde, müssen Sie auch die ResetContext-Funktion aufrufen und dann die AddStroke-Funktion aufrufen, um die Striche aus dem InkDisp-Objekt dem Erkennungskontext hinzuzufügen. Dies erfolgt automatisch, wenn Sie den Erkennungskontext an das InkDisp-Objekt anfügen.

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