Freigeben über


HRECOGNIZER und HRECOCONTEXT

Sie verweisen auf eine Freihanderkennung mit einem HRECOGNIZER-Handle und einem Erkennungskontext als HRECOCONTEXT-Handle .

Eine Erkennungs-DLL (Dynamic Link Library) kann Erkennungen für mehr als eine Sprache implementieren. Wenn ja, wird jede Sprache von einer CLSID ausgewählt, die beim Erstellen des IInkRecognizer-Objekts in der Anwendung übergeben wird. Darüber hinaus kann eine Erkennungs-DLL mehrere Erkennungshandles erstellen, wenn sie geladen wird, eine oder mehrere für jede erkannte Sprache.

Ein Erkennungskontext wird erstellt, um das Ereignis der Erkennung eines bestimmten Freihandteils darzustellen. Wenn der Kontext erstellt wird, wird das zugeordnete Erkennungsobjekthandle an die CreateContext-Funktion übergeben. Dadurch wird die Sprache dem Erkennungskontext zugeordnet.

Ein Erkennungskontext kann die Erkennung aller Freihandeingaben im Textkörper einer E-Mail, die Freihandeingabe eines einzelnen Felds innerhalb einer Anwendung oder eine einzelne Textzeile darstellen, die im Tablet PC-Eingabebereich geschrieben wurde. Die Freihandmenge in einem einzelnen Erkennungskontext kann von einem einzelnen Strich bis hin zu einer ganzen Seite oder mehr variieren.

Der Erkennungskontext wird durch die Einstellungen von definiert:

  • Der Leitfaden zur Erkennung.
  • Alle Fakten.
  • Alle Flags.
  • Der Textkontext.
  • Beliebige Wortliste.
  • Der AutoVervollständigen-Modus des Zeichens.

Das Handle für den Erkennungskontext wird an alle Funktionen übergeben, die diese Einstellungen verwenden. Durch Ändern einer Einstellung wird der Erkennungskontext geändert.

Die Anwendung kann mehrere Kontexte verwenden, um Freihandeingaben aus verschiedenen Teilen des Bildschirms zu erkennen. Ein einzelner Kontext kann mehrere Textzeilen erkennen. Ein einzelner Kontext kann jedoch nicht zwei Nebeneinander geschriebene Absätze verarbeiten, z. B. mehrere Spalten in einem Zeitungsartikel.

Um neue Freihandeingaben zu erkennen, erstellen Sie einen neuen Kontext. Alternativ können Sie die CloneContext-Funktion verwenden, um eine Kopie eines Kontexts zu erstellen, der nicht über die Freihand und Ergebnisse verfügt, oder die ResetContext-Funktion , um einen Kontext der Freihandeingabe und der Ergebnisse zu löschen. Mit diesen Ansätzen kann eine Freihandanwendung einen Kontext wiederverwenden.

SetGuide-Funktion

GetGuide-Funktion

SetFactoid-Funktion

SetFlags-Funktion

SetEnabledUnicodeRanges-Funktion

GetEnabledUnicodeRanges-Funktion

SetCACMode-Funktion

SetTextContext-Funktion

SetWordList-Funktion