IInkRecognizerContext::p utref_Guide-Methode (msinkaut.h)

Dient zum Abrufen oder Festlegen des InkRecognizerGuide für die Freihandeingabe.

Diese Eigenschaft ist Lese-/Schreibzugriff.

Syntax

HRESULT putref_Guide(
  IInkRecognizerGuide *RecognizerGuide
);

Parameter

RecognizerGuide

Zurückgegebener Wert

Nichts

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 den InkRecognizerContext anfügen, oder Sie müssen die InkStrokes-Auflistung auf NULL festlegen und dann den Guide (und mögliches Erneutes Anfügen der InkStrokes-Auflistung) festlegen.

Die InkRecognizerCapabilities-Aufzählung 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 auf einem IInkRecognizer - oder InkRecognizerContext-Objekt festzulegen. Die einzige Möglichkeit, eine Erkennung in einen bestimmten Modus zu versetzen, besteht darin, die Führungslinie mithilfe der Guide-Eigenschaft festzulegen. Wenn Sie die Guide-Eigenschaft nicht festlegen, wird die Erkennung standardmäßig im FreeInput-Modus ausgeführt (wenn die Erkennung in der Lage ist). Eine weitere Möglichkeit zum Festlegen der Erkennung in den FreeInput-Modus besteht darin, die Guide-Eigenschaft auf ein InkRecognizerGuide-Objekt festzulegen, das seine Columns-Eigenschaft auf Null und die Rows-Eigenschaft auf Null festgelegt hat.

Wenn Sie die Guide-Eigenschaft auf ein InkRecognizerGuide-Objekt festlegen, dessen Columns-Eigenschaft auf Null festgelegt ist, und dessen Rows-Eigenschaft auf 1 oder mehr festgelegt ist, befindet sich die Erkennung im IRC_LinedInput Modus (wenn die Erkennung 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 festgelegt ist und dessen Columns-Eigenschaft auf 1 oder mehr festgelegt ist, befindet sich die Erkennung im IRC_LinedInput Modus (wenn die Erkennung in der Lage ist) für vertikale Schreibvorgänge. 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-Objektsentweder 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 festgelegt ist und dessen Rows-Eigenschaft auf 1 oder mehr festgelegt ist, befindet sich die Erkennung im IRC_BoxedInput Modus (wenn die Erkennung in der Lage ist).

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

Informationen zum Abfragen, welche Funktionen oder Modi von einer bestimmten Erkennung verfügbar sind, finden Sie in der Capabilities-Eigenschaft des IInkRecognizer-Objekts . Im Allgemeinen unterstützen Erkennungen des lateinischen Skripts freie Eingaben und horizontale Zeileneingaben, Erkennungen von ostasiatischen Zeichen unterstützen freie Eingaben und Boxeingaben, und die Gestenerkennung unterstützt nur freie Eingaben.

Anforderungen

Siehe auch

Capabilities-Eigenschaft

Columns-Eigenschaft

IInkRecognizer-Schnittstelle

IInkRecognizerContext

InkRecognizerCapabilities-Aufzählung

InkRecognizerContext-Klasse

InkRecognizerGuide-Klasse

InkStrokes-Auflistung

Rows-Eigenschaft