IInkAnalyzer :: CreateAnalysisHint, méthode
Ajoute un nouveau nœud d’indicateur d’analyse avec une zone infinie à la IInkAnalyzer.
Syntaxe
HRESULT CreateAnalysisHint(
[out] IContextNode **ppAnalysisHint
);
Paramètres
-
ppAnalysisHint [ à]
-
Nouveau nœud d’indicateur d’analyse.
Valeur retournée
Consultez classes et interfaces-analyse de l’encre pour obtenir une description des valeurs de retour.
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 Factoid et des informations de guide pour les champs dans une application de formulaire.
Cette méthode crée un nouveau 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 (consultez 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 de propriétés de l' indicateur d’analyse .
Si une indication est assignée à une zone infinie, appelée indication globale, le IInkAnalyzer applique le contexte de l’indicateur à toute l’encre qui ne se trouve 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 la réanalyse. Pour marquer la zone dans l’indicateur pour la réanalyse, utilisez la méthode IInkAnalyzer :: SetDirtyRegion pour définir la région de modification sur l’Union de la région et de la zone de modification actuelles de l’indicateur d’analyse.
Lorsque vous utilisez des indicateurs pour une application de formulaire, l’application doit éviter de mélanger le contexte de texte avec de l’encre 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’encre à des zones sur des pages ; tout contexte de texte interfère avec cette association d’entrée manuscrite. 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êche l’encre d’être associée à la zone d’indication.
Pour plus d’informations sur l’analyse des encres, consultez vue d’ensemblede l’analyse de l’encre.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Applications de bureau Windows XP Édition Tablet PC [ uniquement] |
| Serveur minimal pris en charge |
Aucun pris en charge |
| En-tête |
|
| DLL |
|