Méthode IInkRecognizerContext::get_Guide (msinkaut.h)

Article
08/25/2023

Obtient ou définit le InkRecognizerGuide à utiliser pour l’entrée manuscrite.

Cette propriété est en lecture/écriture.

Syntaxe

HRESULT get_Guide(
  IInkRecognizerGuide **RecognizerGuide
);

Paramètres

RecognizerGuide

Valeur de retour

None

Notes

La définition de la propriété Guide réussit uniquement si la collection InkStrokes a la valeur NULL. Vous devez définir la propriété Guide avant d’attacher la collection InkStrokes à InkRecognizerContext ou vous devez définir la collection InkStrokes sur NULL , puis définir le Guide (et éventuellement rattacher la collection InkStrokes).

L’énumération InkRecognizerCapabilities contient les indicateurs IRC_FreeInput, IRC_LinedInput et IRC_BoxedInput. Ces indicateurs spécifient les fonctionnalités d’un module de reconnaissance, mais étant donné qu’ils sont en lecture seule, il n’existe aucun moyen de les définir directement sur un objet IInkRecognizer ou InkRecognizerContext . La seule façon de placer un module de reconnaissance dans un mode spécifique consiste à définir le guide à l’aide de la propriété Guide . Si vous ne définissez pas la propriété Guide , le module de reconnaissance utilise par défaut le mode FreeInput (si le module de reconnaissance est capable de le faire). Une autre façon de définir le module de reconnaissance en mode FreeInput consiste à définir la propriété Guide sur un objet InkRecognizerGuide dont la propriété Columns est définie sur zéro et sa propriété Rows sur zéro.

Si vous définissez la propriété Guide sur un objet InkRecognizerGuide dont la propriété Columns est définie sur zéro et sa propriété Rows sur 1 ou plus, le module de reconnaissance est en mode IRC_LinedInput (si le module de reconnaissance est capable de le faire). Le module de reconnaissance utilise la propriété Rows pour contrôler le nombre de lignes.

Si vous définissez la propriété Guide sur un objet InkRecognizerGuide dont la propriété Rows est définie sur zéro et sa propriété Columns sur 1 ou plus, le module de reconnaissance est en mode IRC_LinedInput (si le module de reconnaissance est capable de le faire) pour l’écriture verticale. L’outil de reconnaissance utilise la propriété Columns pour contrôler le nombre de lignes verticales. Si le module de reconnaissance en est capable, la propriété Capabilities de l’objet IInkRecognizer retourne IRC_DownAndLeft ou IRC_DownAndRight, ou les deux.

Si vous définissez la propriété Guide sur un objet InkRecognizerGuide dont la propriété Columns est définie sur 1 ou plus et sa propriété Rows sur 1 ou plus, le module de reconnaissance est en mode IRC_BoxedInput (si le module de reconnaissance en est capable).

Si vous définissez le mode sur un mode qui n’est pas disponible à partir de ce module de reconnaissance, une erreur est retournée.

Pour plus d’informations sur la façon d’interroger les fonctionnalités ou modes disponibles à partir d’un module de reconnaissance spécifique, consultez la propriété Capabilities de l’objet IInkRecognizer . En général, les générateurs de reconnaissance de script latin prennent en charge l’entrée libre et l’entrée en ligne horizontale, les reconnaissances de caractères d’Asie de l’Est prennent en charge l’entrée gratuite et l’entrée en boîte, et le module de reconnaissance de mouvements prend uniquement en charge l’entrée libre.

Spécifications


Client minimal pris en charge	Windows XP Édition Tablet PC [applications de bureau uniquement]
Serveur minimal pris en charge	Aucun pris en charge
Plateforme cible	Windows
En-tête	msinkaut.h
Bibliothèque	InkObj.dll