Partager via


Méthode IInkAnalyzer::Search

Fournit une recherche approximative, insensible à la casse, basée sur des expressions pour les traits d’écriture analysés et les traits de dessin analysés qui ont des types reconnus.

Syntaxe

HRESULT Search(
  [in]      BSTR  bstrPhraseToMatch,
  [in, out] ULONG *pulSearchResultCount,
  [out]     ULONG **ppulStrokeCountPerResult,
  [in, out] ULONG *pulStrokeIdsCount,
  [out]     ULONG **ppulStrokeIds
);

Paramètres

bstrPhraseToMatch [in]

Expression qui sera trouvée dans les alternatives pour les traits actuellement analysés.

pulSearchResultCount [in, out]

Nombre maximum de résultats retournés pour une recherche.

ppulStrokeCountPerResult [out]

Pointeur vers un tableau du nombre de traits dans chaque résultat de recherche.

pulStrokeIdsCount [in, out]

Nombre d’ID de trait dans ppulStrokeIds.

ppulStrokeIds [out]

Pointeur vers un tableau d’ID de traits, qui représente un ensemble de jeux de traits.

Valeur retournée

Pour obtenir une description des valeurs de retour, consultez Classes et interfaces – Analyse des entrées manuscrites.

Notes

Cette recherche trouve des sous-chaînes de mots multiples et de mots uniques. Les résultats de la reconnaissance alternative et les segmentations alternatives sont recherchés.

Toutes les chaînes entrantes seront converties en une seule casse pour la comparaison utilisant le LCID du thread actuel pour effectuer cette conversion afin de respecter les conventions de cas culturels.

La chaîne transmise est traitée comme une expression. Les mots et les caractères doivent apparaître dans les variantes des traits dans l’ordre spécifié. Les premiers et derniers mots de l’expression peuvent être mis en correspondance en tant que sous-chaînes (le premier mot apparaissant à la fin d’une alternative et le dernier mot apparaissant au début d’une alternative), mais tous les autres mots (ceux à l’intérieur de l’expression) doivent apparaître sous forme de mots entiers.

Si la chaîne transmise n’a pas d’espace entre les caractères, la sous-chaîne peut être trouvée n’importe où à l’intérieur d’un seul mot dans une alternative.

Seule la présence ou l’absence d’espace entre les caractères modifie les résultats de la recherche. Les espaces qui ne sont pas entourées de caractères sont ignorées. Le type de l’espace est ignoré (une tabulation ou une espace entre les caractères donne le même résultat). La quantité d’espaces n’a pas d’importance : une espace ou deux espaces entre les caractères donneront le même résultat.

La recherche ne génère pas d’événements PopulateContextNode. Seuls les traits qui ont déjà été remplis seront recherchés.

Configuration requise

Condition requise Value
Client minimal pris en charge
Windows XP édition Tablet PC [applications de bureau uniquement]
Serveur minimal pris en charge
Aucun pris en charge
En-tête
IACom.h (nécessite également IACom_i.c)
DLL
IACom.dll

Voir aussi

IInkAnalyzer