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

Article
02/29/2024

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 au sein de 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 au sein de l’alternative. Ce paramètre doit être supérieur à 0. Ce paramètre est ajusté à la longueur du plus petit ensemble d’un ou de plusieurs segments qui comprend la sélection d’entrée.

[out, retval] GetStrokesFromTextRange

Au retour, contient un pointeur vers la collection de traits qui correspond à la plage connue de texte reconnu.

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_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 davantage GetStrokesFromTextRange, considérez une collection de traits qui a été reconnue et pour laquelle la meilleure alternative pour ces traits est « comment allez-vous ». Le paramètre passé à la méthode correspond à une plage dans (ou éventuellement la totalité) de 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 inclut l’ensemble de la plage d’entrée. Si le paramètre selectionStart est 0 et que le paramètre selectionLength est 5, en créant une plage correspondant au « how a » 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 comprend la plage d’entrée.

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

Configuration requise

Condition requise	Valeur
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

Voir aussi

GetStrokesFromStrokeRanges, méthode

GetTextRangeFromStrokes, méthode

Interface alternative IInkRecognition

InkStrokes Collection

Partager via