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

Récupère la collection qui correspond au plus petit ensemble de segments de reconnaissance qui contient une plage de caractères spécifiée dans l’autre.

Syntaxe

HRESULT GetStrokesFromTextRange(
  [in, out]     long        *selectionStart,
  [in, out]     long        *selectionLength,
  [out, retval] IInkStrokes **GetStrokesFromTextRange
);

Paramètres

[in, out] selectionStart

Début de la plage de caractères dans cette alternative. Le caractère à la position selectionStart est inclus dans la plage de texte reconnu. Ce paramètre est ajusté au début du plus petit ensemble reconnu d’un ou plusieurs segments qui inclut la sélection d’entrée. Le paramètre selectionStart est un index de base zéro dans les caractères du texte de l’alternative de reconnaissance.

[in, out] selectionLength

Longueur de la plage de caractères dans l’autre. Ce paramètre doit être supérieur à 0. Ce paramètre est ajusté à la longueur du plus petit ensemble d’un ou plusieurs segments qui inclut la sélection d’entrée.

[out, retval] GetStrokesFromTextRange

Une fois retourné, contient un pointeur vers la collection de traits qui correspond à la plage connue de texte reconnu.

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_FAIL
Une erreur non spécifiée s’est produite.
E_OUTOFMEMORY
Impossible d’allouer l’objet d’assistance du gestionnaire de traits.

Remarques

Pour clarifier plus en détail GetStrokesFromTextRange, considérez une collection de traits qui ont été reconnus et pour lesquels le meilleur alternative pour ces traits est « comment êtes-vous ». Le paramètre passé à la méthode est une plage dans (ou éventuellement tout) ce résultat de chaîne. Cette alternative contient cinq segments, un pour chaque mot et un pour chaque espace. Les traits retournés correspondent au plus petit ensemble de segments qui incluent toutes les plages d’entrée. Si le paramètre selectionStart est 0 et que le paramètre selectionLength est 5, la création d’une plage correspondant à la « façon » de la chaîne de résultat, les traits retournés sont tous les traits reconnus qui composent les segments « how are ». Il s’agit du plus petit ensemble de segments qui inclut la plage d’entrée.

Dans les modules de reconnaissance de mots et de caractères, les espaces sont comptés comme un caractère. Si la sélection d’entrée correspond à un caractère d’espace, cette méthode retourne et vide la collection InkStrokes .

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

GetStrokesFromStrokeRanges, méthode

GetTextRangeFromStrokes, méthode

IInkRecognition Alternate Interface

InkStrokes, collection