Méthode IInkAnalyzer::CreateAnalysisHint

Ajoute un nouveau nœud d’indicateur d’analyse avec une zone infinie à IInkAnalyzer.

Syntaxe

HRESULT CreateAnalysisHint(
  [out] IContextNode **ppAnalysisHint
);

Paramètres

ppAnalysisHint [out]

Nouveau nœud d’indicateur d’analyse.

Valeur retournée

Pour obtenir une description des valeurs de retour, consultez Classes et interfaces - Analyse de l’encre .

Notes

Attention

Pour éviter une fuite de mémoire, appelez IUnknown::Release sur ppAnalysisHint lorsque vous n’avez plus besoin d’utiliser l’objet.

Pour fournir des informations de contexte supplémentaires pour IInkAnalyzer, vous pouvez ajouter des indicateurs d’analyse à l’analyseur d’encre. Les indicateurs d’analyse peuvent améliorer la précision de la reconnaissance. Par exemple, vous pouvez ajouter des informations factoid et un guide pour les champs d’une application de formulaire.

Cette méthode crée un nouvel IContextNode avec un type de nœud de contexte AnalysisHint (voir IContextNode::GetType) et ajoute le nouvel indicateur en tant que sous-nœud du nœud racine de l’objet IInkAnalyzer (voir IContextNode::GetSubNodes et IInkAnalyzer::GetRootNode, méthode).

Pour ajouter des informations de contexte à l’indicateur, utilisez IContextNode::AddPropertyData avec le paramètre pPropertyDataId défini sur l’une des constantes Analysis Hint Properties .

Si un indicateur se voit attribuer une zone infinie, appelée indicateur global, IInkAnalyzer applique le contexte de l’indicateur à toutes les entrées manuscrites qui ne se trouvent pas dans la zone d’un autre indicateur. Plusieurs indicateurs peuvent être attachés à un seul IInkAnalyzer. Toutefois, un seul indicateur global peut être attaché à un analyseur d’encre unique, et aucun indicateur non global ne peut se chevaucher. Pour plus d’informations sur les types d’informations de contexte qu’un indicateur peut fournir, consultez Propriétés de l’indicateur d’analyse.

L’ajout d’un indicateur d’analyse ne marque pas la zone de l’indicateur pour une réanalyse. Pour marquer la zone dans l’indicateur de réanalyse, utilisez la méthode IInkAnalyzer::SetDirtyRegion pour définir la région sale sur l’union de la région sale actuelle et de la zone de l’indicateur d’analyse.

Lors de l’utilisation d’indicateurs pour une application de formulaire, l’application doit éviter de mélanger le contexte de texte avec l’entrée manuscrite dans les formulaires. Cela signifie par exemple que les noms de champs de texte ne doivent pas être créés dans l’arborescence d’analyse. Les indicateurs sont destinés à associer l’entrée manuscrite aux zones des pages ; tout contexte de texte interfère avec cette association d’entrée à indice. L’opération d’analyse peut fusionner l’encre et le contexte de texte dans la même région d’écriture, ce qui empêcherait l’entrée manuscrite d’être associée à la zone d’indicateur.

Pour plus d’informations sur l’analyse manuscrite, consultez Vue d’ensemble de l’analyse d’encre.

Spécifications

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
En-tête	IACom.h (nécessite également IACom_i.c)
DLL	IACom.dll

Voir aussi

IInkAnalyzer

IContextNode::AddPropertyData

IInkAnalyzer::D eleteAnalysisHint, méthode

IInkAnalyzer::GetAnalysisHints, méthode

IInkAnalyzer::GetAnalysisHintsByName, méthode

Propriétés de l’indicateur d’analyse

Informations de référence sur l’analyse manuscrite