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

Article
03/04/2024

Récupère la plus petite collection InkStrokes qui contient une collection InkStrokes d’entrée 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 stroke à utiliser pour rechercher la plus petite collection de traits de l’autre 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ée connue de traits et pour laquelle le module de reconnaissance peut fournir des alternatives.

Valeur retournée

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

Code de retour	Description
S_OK	Réussite.
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 strokes 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 plus petit résultat de reconnaissance qui inclut tous les traits d’entrée.

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

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

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP Édition Tablette 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

Voir aussi

GetStrokesFromTextRange, méthode

GetTextRangeFromStrokes, méthode

IInkRecognition Alternate Interface

InkStrokes Collection

Partager via