IInkRecognizerContext::get_Guide-Methode (msinkaut.h)

Artikel
08/25/2023

Ruft den InkRecognizerGuide ab, der für die Freihandeingabe verwendet werden soll, oder legt diesen fest.

Dies ist eine Eigenschaft mit Lese- und Schreibzugriff.

Syntax

HRESULT get_Guide(
  IInkRecognizerGuide **RecognizerGuide
);

Parameter

RecognizerGuide

Rückgabewert

Keine

Bemerkungen

Das Festlegen der Guide-Eigenschaft ist nur erfolgreich, wenn die InkStrokes-AuflistungNULL ist. Sie müssen die Guide-Eigenschaft festlegen, bevor Sie die InkStrokes-Auflistung an inkRecognizerContext anfügen, oder Sie müssen die InkStrokes-Auflistung auf NULL festlegen und dann den Guide festlegen (und die InkStrokes-Auflistung möglicherweise erneut anfügen).

Die InkRecognizerCapabilities-Enumeration enthält die Flags IRC_FreeInput, IRC_LinedInput und IRC_BoxedInput . Diese Flags geben die Funktionen einer Erkennung an, aber da sie schreibgeschützt sind, gibt es keine Möglichkeit, diese direkt für ein IInkRecognizer - oder InkRecognizerContext-Objekt festzulegen. Die einzige Möglichkeit, eine Erkennung in einen bestimmten Modus zu versetzen, besteht darin, die Anleitung mithilfe der Guide-Eigenschaft festzulegen. Wenn Sie die Guide-Eigenschaft nicht festlegen, wird der Erkennungsmodus standardmäßig auf FreeInput-Modus festgelegt (sofern die Erkennung dazu in der Lage ist). Eine andere Möglichkeit, die Erkennung in den FreeInput-Modus festzulegen, besteht darin, die Guide-Eigenschaft auf ein InkRecognizerGuide-Objekt festzulegen, dessen Columns-Eigenschaft auf 0 und die Rows-Eigenschaft auf 0 festgelegt ist.

Wenn Sie die Guide-Eigenschaft auf ein InkRecognizerGuide-Objekt festlegen, dessen Columns-Eigenschaft auf Null und die Rows-Eigenschaft auf 1 oder mehr festgelegt ist, befindet sich die Erkennung im IRC_LinedInput Modus (wenn die Erkennung dazu in der Lage ist). Die Erkennung verwendet die Rows-Eigenschaft , um die Anzahl der Zeilen zu steuern.

Wenn Sie die Guide-Eigenschaft auf ein InkRecognizerGuide-Objekt festlegen, dessen Rows-Eigenschaft auf Null und die Columns-Eigenschaft auf 1 oder mehr festgelegt ist, befindet sich die Erkennung für vertikales Schreiben im IRC_LinedInput Modus (sofern die Erkennung dazu in der Lage ist). Die Erkennung verwendet die Columns-Eigenschaft , um die Anzahl der vertikalen Linien zu steuern. Wenn die Erkennung dazu in der Lage ist, gibt die Capabilities-Eigenschaft des IInkRecognizer-Objekts entweder IRC_DownAndLeft oder IRC_DownAndRight oder beides zurück.

Wenn Sie die Guide-Eigenschaft auf ein InkRecognizerGuide-Objekt festlegen, dessen Columns-Eigenschaft auf 1 oder mehr und die Rows-Eigenschaft auf 1 oder mehr festgelegt ist, befindet sich die Erkennung im IRC_BoxedInput Modus (wenn die Erkennung dazu in der Lage ist).

Wenn Sie den Modus auf einen festlegen, der in dieser Erkennung nicht verfügbar ist, wird ein Fehler zurückgegeben.

Informationen zum Abfragen der verfügbaren Funktionen oder Modi einer bestimmten Erkennung finden Sie in der Capabilities-Eigenschaft des IInkRecognizer-Objekts . Im Allgemeinen unterstützen Erkennungen der lateinischen Schrift freie Eingabe und horizontale zeilenbasierte Eingabe, Erkennungen ostasiatischer Zeichen unterstützen freie Eingabe und boxed Input, und die Gestenerkennung unterstützt nur freie Eingabe.

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP Tablet PC Edition [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	msinkaut.h
Bibliothek	InkObj.dll