Metodo IInkAnalyzer::CreateAnalysisHint

Aggiunge un nuovo nodo hint di analisi con un'area infinita all'IInkAnalyzer.

Sintassi

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

Parametri

ppAnalysisHint [out]

Nuovo nodo hint di analisi.

Valore restituito

Per una descrizione dei valori restituiti, vedere Classi e interfacce - Analisi input penna .

Commenti

Attenzione

Per evitare una perdita di memoria, chiamare IUnknown::Release in ppAnalysisHint quando non è più necessario usare l'oggetto.

Per fornire informazioni di contesto aggiuntive per IInkAnalyzer, è possibile aggiungere hint di analisi all'analizzatore input penna. Gli hint di analisi possono migliorare l'accuratezza del riconoscimento. Ad esempio, è possibile aggiungere informazioni factoid e guide per i campi in un'applicazione modulo.

Questo metodo crea un nuovo IContextNode con un tipo di nodo di contesto di AnalysisHint (vedere IContextNode::GetType) e aggiunge il nuovo hint come sottonode del nodo radice dell'oggetto IInkAnalyzer (vedere IContextNode::GetSubNodes e IInkAnalyzer::GetRootNode Method).

Per aggiungere informazioni di contesto all'hint, usare IContextNode::AddPropertyData con il parametro pPropertyDataId impostato su una delle costanti Proprietà hint di analisi .

Se viene assegnato un hint a un'area infinita, definito hint globale, IInkAnalyzer applica il contesto dell'hint a tutti gli input penna che non si trovano all'interno dell'area di un altro hint. È possibile collegare più hint a un singolo IInkAnalyzer. Tuttavia, solo un hint globale può essere collegato a un singolo analizzatore penna e non è possibile sovrapporre hint non globali. Per altre informazioni sui tipi di informazioni di contesto che un hint può fornire, vedere Proprietà hint di analisi.

L'aggiunta di un hint di analisi non contrassegna l'area dell'hint per la rianalisi. Per contrassegnare l'area all'interno dell'hint per la rianalisi, usare il metodo IInkAnalyzer::SetDirtyRegion per impostare l'area sporca sull'unione dell'area sporca corrente e dell'area dell'hint di analisi.

Quando si usano hint per un'applicazione modulo, l'applicazione deve evitare di combinare il contesto di testo con l'input penna nei moduli. Ciò significa, ad esempio, che i nomi dei campi di testo non devono essere creati nell'albero di analisi. Gli hint sono destinati a associare l'input penna alle aree nelle pagine; qualsiasi contesto di testo interferisce con questa associazione penna a hint. L'operazione di analisi può unire l'input penna e il contesto di testo nella stessa area di scrittura che impedisce l'associazione dell'input penna all'area hint.

Per altre informazioni sull'analisi dell'input penna, vedere Panoramica dell'analisi dell'input penna.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP Tablet PC Edition [solo app desktop]
Server minimo supportato	Nessuno supportato
Intestazione	IACom.h (richiede anche IACom_i.c)
DLL	IACom.dll

Vedi anche

IInkAnalyzer

IContextNode::AddPropertyData

Metodo IInkAnalyzer::D eleteAnalysisHint

Metodo IInkAnalyzer::GetAnalysisHints

Metodo IInkAnalyzer::GetAnalysisHintsByName

Proprietà dell'hint di analisi

Informazioni di riferimento per l'analisi dell'input penna