IInkRecognizerContext::p utref_Guide-Methode (msinkaut.h)
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 putref_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 möglicherweise die InkStrokes-Auflistung 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ützter 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 für die Erkennung standardmäßig freeInput-Modus verwendet (sofern die Erkennung dazu 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, 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 in IRC_LinedInput Modus (sofern 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 in 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 in IRC_BoxedInput Modus (sofern die Erkennung dazu 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 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 Eingaben und horizontale zeilenbasierte Eingaben, Erkennungen ostasiatischer Zeichen unterstützen freie Eingaben und Eingaben in Boxen, und die Gestenerkennung unterstützt nur freie Eingaben.
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 |