Metodo InkAnalyzerBase.CreateAnalysisHint

Articolo
10/29/2008

Aggiornamento: novembre 2007

Aggiunge un nuovo suggerimento di analisi con un'area vuota all'analizzatore dell'input penna.

Spazio dei nomi: System.Windows.Ink.AnalysisCore
Assembly: IACore (in IACore.dll)

Sintassi

'Dichiarazione
Public Function CreateAnalysisHint As ContextNodeBase
'Utilizzo
Dim instance As InkAnalyzerBase
Dim returnValue As ContextNodeBase

returnValue = instance.CreateAnalysisHint()

public ContextNodeBase CreateAnalysisHint()

public:
ContextNodeBase^ CreateAnalysisHint()

public ContextNodeBase CreateAnalysisHint()

public function CreateAnalysisHint() : ContextNodeBase

Valore restituito

Tipo: System.Windows.Ink.AnalysisCore.ContextNodeBase
Nuovo suggerimento di analisi.

Note

Per fornire informazioni di contesto aggiuntive, è possibile aggiungere suggerimenti di analisi all'analizzatore dell'input penna. I suggerimenti di analisi possono migliorare l'accuratezza del riconoscimento. Ad esempio, è possibile aggiungere un controllo oggetto e informazioni guida per i campi in un'applicazione del form.

Questo metodo crea un nuovo oggetto ContextNodeBase con un valore della proprietà Type di AnalysisHint() e aggiunge il nuovo suggerimento all'insieme SubNodes della proprietà RootNode dell'analizzatore dell'input penna.

Per aggiungere informazioni di contesto al suggerimento, utilizzare il metodo AddPropertyData dell'oggetto ContextNodeBase con il parametro propertyDataId impostato su uno dei GUID nella classe PropertyGuidsForAnalysisHintsBase.

Se un'area infinita viene assegnata a un suggerimento, denominato suggerimento globale, l'analizzatore dell'input penna applica il contesto del suggerimento a tutti gli input penna che non si trovano all'interno dell'area di un altro suggerimento. È possibile associare più suggerimenti a un solo analizzatore. È tuttavia possibile associare solo un suggerimento globale a un solo analizzatore dell'input penna e non è possibile sovrapporre alcun suggerimento non globale. Per ulteriori informazioni sui tipi di informazioni sul contesto che un suggerimento può fornire, vedere PropertyGuidsForAnalysisHintsBase.

L'aggiunta di un suggerimento di analisi non contrassegna l'area del suggerimento per una nuova analisi. Per contrassegnare l'area all'interno del suggerimento per una nuova analisi, chiamare il metodo Union dell'oggetto DirtyRegion con l'oggetto Location del suggerimento.

Per ulteriori informazioni sull'analisi dell'input penna, vedere Ink Analysis Overview.

Esempi

Nell'esempio seguente viene creato un suggerimento di analisi, theAnalysisHint, per l'oggetto InkAnalyzerBase, theInkAnalyzerBase. Successivamente theAnalysisHint viene trasformato in un suggerimento globale e vengono aggiunte le proprietà AllowPartialDictionaryTerms e Name al suggerimento.

' Add a new, global analysis hint to the ink analyzer. 
Dim theAnalysisHintNode As System.Windows.Ink.AnalysisCore.ContextNodeBase = _
    theInkAnalyzerBase.CreateAnalysisHint()
theAnalysisHintNode.Location.MakeInfinite()
theAnalysisHintNode.AddPropertyData( _
    System.Windows.Ink.AnalysisCore.PropertyGuidsForAnalysisHintsBase.AllowPartialDictionaryTerms, _
    True)
theAnalysisHintNode.AddPropertyData( _
    System.Windows.Ink.AnalysisCore.PropertyGuidsForAnalysisHintsBase.Name, _
    "Allow Partial Dictionary Terms")

// Add a new, global analysis hint to the ink analyzer. 
System.Windows.Ink.AnalysisCore.ContextNodeBase theAnalysisHintNode =
    theInkAnalyzerBase.CreateAnalysisHint();
theAnalysisHintNode.Location.MakeInfinite();
theAnalysisHintNode.AddPropertyData(
    System.Windows.Ink.AnalysisCore.PropertyGuidsForAnalysisHintsBase.AllowPartialDictionaryTerms,
    true);
theAnalysisHintNode.AddPropertyData(
    System.Windows.Ink.AnalysisCore.PropertyGuidsForAnalysisHintsBase.Name,
    "Allow Partial Dictionary Terms");

Piattaforme

Windows Vista, Windows XP SP2, Windows Server 2003

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.