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 |
|
| DLL |
|