IInkRecognitionAlternate ::GetStrokesFromStrokeRanges, méthode (msinkaut.h)

Récupère la plus petite collection InkStrokes qui contient une collection InkStrokes connue et pour laquelle l’objet IInkRecognizer peut fournir des alternatives.

Syntaxe

HRESULT GetStrokesFromStrokeRanges(
  [in]          IInkStrokes *Strokes,
  [out, retval] IInkStrokes **GetStrokesFromStrokeRanges
);

Paramètres

[in] Strokes

Collection d’objets traits à utiliser pour rechercher la plus petite collection de traits du résultat de reconnaissance qui contient cette collection.

[out, retval] GetStrokesFromStrokeRanges

Lorsque cette méthode est retournée, contient un pointeur vers la plus petite collection de traits qui contient une collection d’entrées connue de traits et pour laquelle le module de reconnaissance peut fournir des alternatives.

Valeur renvoyée

Cette méthode peut retourner l’une de ces valeurs.

Code de retour Description
S_OK
Opération réussie.
E_POINTER
Un paramètre contenait un pointeur non valide.
E_INK_EXCEPTION
Une exception s’est produite à l’intérieur de la méthode.
E_INK_MISMATCHED_INK_OBJECT
Le paramètre traits est associé à un autre objet Ink.
E_FAIL
Une erreur non spécifiée s’est produite.

Remarques

La collection retournée peut correspondre à la collection d’entrée, ou elle peut être plus grande si la collection d’entrée ne correspond qu’à une partie du résultat de reconnaissance le plus petit qui inclut tous les traits d’entrée.

Cette méthode est la plus utile pour la sélection de mots en un clic. Par exemple, pour renvoyer les traits qui composent le mot que vous avez cliqué, vous pouvez cliquer sur un trait, appeler la méthode HitTest de l’objet IInkStrokeDisp pour récupérer le trait qui a été cliqué, puis appeler GetStrokesFromStrokeRanges.

Les plages de traits sont valides jusqu’à ce que l’objet InkDisp soit modifié.

Exigences

Prérequis Valeur
Client minimum requis Windows XP Tablet PC Edition [applications de bureau uniquement]
Serveur minimal pris en charge Aucun pris en charge
plateforme cible Windows
En-tête msinkaut.h

Voir également

GetStrokesFromTextRange, méthode

GetTextRangeFromStrokes, méthode

IInkRecognition Alternate Interface

InkStrokes, collection