IInkAnalyzer :: Analyze, méthode
Effectue une analyse de l’encre synchrone.
Syntaxe
HRESULT Analyze(
[out] IAnalysisStatus **ppStatus
);
Paramètres
-
ppStatus [ à]
-
Pointeur vers un IAnalysisStatus qui décrit l’état de l’opération d’analyse.
Valeur retournée
Pour obtenir une description des valeurs de retour, consultez classes et interfaces-analysede l’encre.
Remarques
Attention
Pour éviter une fuite de mémoire, appelez IUnknown :: Release sur ppStatus lorsque vous n’avez plus besoin d’utiliser l’état d’analyse.
Cette méthode démarre une opération d’analyse d’encre synchrone. L’analyse de l’encre comprend l’analyse de la disposition, l’écriture et la classification des dessins et la reconnaissance de l’écriture. Cette méthode est retournée une fois l’opération d’analyse terminée.
Cette méthode retourne le _ pointeur E si PpStatus a la valeur null.
Pendant un appel à la méthode IInkAnalyzer :: Analyze ou à la méthode IInkAnalyzer :: BackgroundAnalyze, le IInkAnalyzer analyse l’encre au sein de sa région modifiée (consultez la méthode IInkAnalyzer :: GetDirtyRegion). Toutefois, le IInkAnalyzer peut développer l’opération d’analyse pour inclure les régions voisines.
Cette méthode définit la région de modification de l’objet IInkAnalyzer sur une zone vide. Si un autre thread a ajouté des données de trait qui n’ont pas été analysées, le IInkAnalyzer ajoute le cadre englobant des traits non analysés à sa région modifiée pendant la phase de rapprochement de l’analyse.
Cette méthode retourne une erreur si votre application ne gère pas l’événement _ IAnalysisEvents :: UpdateStrokesCache .
IInkAnalyzer ne déclenche pas les événements _ IAnalysisEvents :: Results et _ IAnalysisEvents :: IntermediateResults en réponse à cette méthode.
Pour modifier la façon dont l’analyse de l’encre est effectuée, utilisez la méthode IInkAnalyzer :: SetAnalysisModes.
Pour plus d’informations sur l’analyse des encres, consultez vue d’ensemblede l’analyse de l’encre.
Exemples
L’exemple suivant effectue une analyse de l’encre de premier plan.
// Perform synchronous ink analysis.
IAnalysisStatus *pAnalysisStatus = NULL;
hr = this->m_spIInkAnalyzer->Analyze(&pAnalysisStatus);
if (SUCCEEDED(hr))
{
// Insert code that processes the analysis results.
}
// Release this reference to the analysis status.
if (pAnalysisStatus != NULL)
{
pAnalysisStatus->Release();
pAnalysisStatus = NULL;
}
Conditions requises
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows Applications de bureau XP Édition Tablet PC [ uniquement] |
| Serveur minimal pris en charge |
Aucun pris en charge |
| En-tête |
|
| DLL |
|