shellhandwriting.h-Header

Aktiviert Freihandeingaben mit einem Stift an oder in der Nähe eines beliebigen Textbearbeitungssteuerelements, ohne den Fokus zuerst auf das Steuerelement festzulegen. Das System bestimmt die Absicht, identifiziert ein Eingabeziel, rendert die Freihandstriche, erkennt die Freihandeingabe als Text (oder eine Geste zum Ändern von Text), schlägt Textkandidaten vor, falls verfügbar, und fügt den neuen oder geänderten Text in das Bearbeitungsfeld des Steuerelements ein.

Dieser Header wird von der Freihandeingabe verwendet. Weitere Informationen finden Sie unter

• Freihandeingabe

Sowohl das Text Services Framework (TSF) als auch Benutzeroberflächenautomatisierung (UIA) werden zur Unterstützung der ShellHandwriting-Funktionalität verwendet.

In den folgenden Schritten wird der grundlegende Prozess beschrieben, der für die ShellHandwriting-Funktionalität verwendet wird.

1. Opt-out-Bestimmung: Ermitteln Sie, ob die Anwendung ShellHandwriting unterstützt. In der Regel Anwendungen, die nicht über robuste Benutzeroberflächenautomatisierung (UIA)-Implementierungen verfügen, oder anwendungen mit benutzerdefinierter Freihandbehandlung.
2. Bestimmung der Absicht: Wenn die App ShellHandwriting unterstützt, bestimmt das System, ob die Zeigereingabe des Stifts an die App übergeben oder für die Handschrift verwendet werden soll.
3. Tap-Bestimmung: Wenn die Stifteingabe für die Handschrift verwendet werden soll, testen Sie, ob die Eingabe von einem umsetzbaren Steuerelement empfangen wurde (z. B. einer Schaltfläche, die Eingaberang hat) und ob ein Steuerelement gefunden wird, das Text empfangen kann (Edit, ComboBox oder Document), das aktiviert, nicht schreibgeschützt ist und den Tastaturfokus akzeptieren kann.
4. Zielbestimmung: Wenn Eingaben für die Handschrift verwendet werden können, wird ein Begrenzungsfeld um einen Teil der Eingabe erstellt, um das Bearbeitungssteuerelement zu bestimmen, das am besten für den Empfang der Freihanderkennungsergebnisse (Zielbestimmung) geeignet ist.
5. Endgültige Feststellung: Wenn ein Zielbearbeitungssteuerelement identifiziert wird und den Fokus erhält, werden verschiedene andere Kontextindikatoren (z. B. Eingabebereich, Sprache, vorhandene Textbegrenzungsrekte) verwendet, um die Angemessenheit zu bestätigen, bevor die Freihanderkennungsergebnisse in das Steuerelement kopiert werden.

shellhandwriting.h enthält die folgenden Programmierschnittstellen:

Schnittstellen

IHandwritingInputRoutingCallback Bietet Unterstützung für das Eingaberouting zum Trennen des Stifteingabebehandlungssystemthreads vom UI-Thread des Eingabeziels.
ITfDetermineProximateHandwritingTargetArgs Stellt das Verhalten der Handschriftantwort und informationen zum zielnäheren Ziel bereit.
ITfFocusHandwritingTargetArgs Stellt das Verhalten der Handschriftantwort und Zielinformationen bereit.
ITfHandwriting Unterstützt Freihandeingaben mit einem Stift in einem beliebigen Bearbeitungsfeld in der Nähe, ohne den Fokus zuerst auf das Bearbeitungssteuerelement festlegen zu müssen. Die Freihandstriche werden gerendert, die Handschrifterkennung (entweder als Text- oder Bearbeitungsgeste) und Text in das Bearbeitungsfeld eingegeben.
ITfHandwritingRequest Anwendungen müssen diese Schnittstelle verwenden, um das System zu benachrichtigen, dass sie die Stifteingabe ausgewertet haben, die nach der Handschriftanforderung aufgetreten ist.
ITfHandwritingSink Unterstützt die Möglichkeit, benutzerdefinierte Schreibverhalten anzugeben, bevor der Fokus auf ein Bearbeitungsfeld festgelegt wird.

Functions

GetHandwritingStrokeIdForPointer Ruft die eindeutige ID des Freihandstrichs ab, der der angegebenen Zeiger-ID zugeordnet ist.
RegisterHandwritingInputRoutingCallback

Enumerationen

TfHandwritingFocusTargetResponse Gibt an, wie ein Client, der die IHandwritingInputRoutingCallback-Schnittstelle implementiert, reagiert, wenn die FocusHandwritingTarget-Funktion aufgerufen wird.
TfHandwritingState Gibt an, wie die Handschrift vom System behandelt wird.
TfInputEvaluation Gibt an, wie die Stifteingabe erkannt werden soll.
TfProximateHandwritingTargetResponse Gibt das unterstützte Schreibverhalten basierend auf der nähen Position eines Handschriftzielobjekts an.