Classe AnalysisHintNode

Articolo
10/29/2008

Aggiornamento: novembre 2007

Fornisce un oggetto InkAnalyzer con un suggerimento di analisi per un'area.

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

Sintassi

'Dichiarazione
Public NotInheritable Class AnalysisHintNode _
    Inherits ContextNode
'Utilizzo
Dim instance As AnalysisHintNode

public sealed class AnalysisHintNode : ContextNode

public ref class AnalysisHintNode sealed : public ContextNode

public final class AnalysisHintNode extends ContextNode

public final class AnalysisHintNode extends ContextNode

Note

Un oggetto AnalysisHintNode fornisce un suggerimento per l'oggetto InkAnalyzer al quale è collegato. Il suggerimento si applica all'area specificata dalla proprietà Location dell'oggetto AnalysisHintNode. Fornisce all'analizzatore dell'input penna informazioni di contesto aggiuntive che vengono utilizzate per migliorare l'accuratezza del riconoscimento. L'oggetto InkAnalyzer applica queste informazioni di contesto quando analizza l'input penna all'interno dell'area del suggerimento.

Se un'area infinita viene assegnata a un suggerimento, denominato suggerimento globale, l'oggetto InkAnalyzer applica il contesto del suggerimento a tutti gli input penna che non si trovano all'interno di altre aree del suggerimento. È possibile associare più suggerimenti a un solo InkAnalyzer. È tuttavia possibile associare solo un suggerimento globale a un solo InkAnalyzer e non è possibile sovrapporre alcun suggerimento non globale. Per ulteriori informazioni sui tipi di informazioni di contesto che un suggerimento può fornire, vedere la pagina riservata ai membri dell'oggetto AnalysisHintNode.

Per aggiungere un suggerimento a un oggetto InkAnalyzer, utilizzare InkAnalyzer.CreateAnalysisHint. Per rimuovere un suggerimento da un oggetto InkAnalyzer, utilizzare InkAnalyzerDeleteAnalysisHint().

Nota

L'aggiunta di un suggerimento a un oggetto InkAnalyzer non modifica l'oggetto DirtyRegion dell'oggetto InkAnalyzer. Per permettere all'oggetto InkAnalyzer di rianalizzare l'input penna all'interno dell'area del suggerimento, utilizzare il metodo Union(AnalysisRegion) dell'oggetto DirtyRegion.

L'oggetto InkAnalyzer aggiorna la proprietà Links del suggerimento se viene chiamato il metodo Analyze o BackgroundAnalyze(). InkAnalyzer aggiunge un oggetto ContextLink tra l'oggetto AnalysisHintNode e ciascun oggetto ContextNode a cui si applica il suggerimento. Se un suggerimento si applica a tutti i discendenti di un oggetto ContextNode, InkAnalyzer associa il suggerimento solo all'oggetto ContextNode e non ai discendenti.

La proprietà Location di un oggetto AnalysisHintNode non verrà utilizzata per applicare il suggerimento a un nodo del sistema di riconoscimento personalizzato. Se si crea un suggerimento con la posizione impostata in modo da includere i tratti nell'oggetto CustomRecognizerNode, il suggerimento non verrà applicato ai tratti. Per applicare correttamente il suggerimento ai tratti in un nodo del sistema di riconoscimento personalizzato, creare un collegamento tra AnalysisHintNode e CustomRecognizerNode prima di chiamare Analyze. Si supponga, ad esempio, che vi sia un oggetto AnalysisHintNode denominato theAnalysisHint e un oggetto CustomRecognizerNode denominato theCustomRecognizerNode. Per creare un collegamento tra i due, utilizzare theAnalysisHint.Links.Add(theCustomRecognizerNode, ContextLinkDirection.LinksWith).

Solo un suggerimento non globale può essere applicato a un oggetto CustomRecognizerNode. Per rimuovere un suggerimento non globale da un oggetto CustomRecognizerNode, utilizzare ContextLinkCollectionRemove() per rimuovere il collegamento dalla proprietà Links di CustomRecognizerNode.

Se un suggerimento non globale per un'area non vuota si applica a un oggetto CustomRecognizerNode, InkAnalyzer applica il contesto del suggerimento a CustomRecognizerNode e all'input penna all'interno dell'area del suggerimento.

Non viene creato o eliminato alcun collegamento di un oggetto AnalysisHintNode a CustomRecognizerNode quando viene eseguita l'analisi.

Se i suggerimenti vengono utilizzati in un'applicazione del form, evitare di combinare il contesto di testo con l'input penna. I suggerimenti devono associare l'input penna alle aree nelle pagine e qualsiasi contesto di testo interferirà con questa associazione dell'input penna al suggerimento. Pertanto, i nomi dei campi di testo non devono essere creati nella struttura ad albero dell'analisi altrimenti l'operazione di analisi può unire l'input penna e il contesto di testo nella stessa area di scrittura, impedendo così l'associazione dell'input penna all'area del suggerimento.

Esempi

In questo esempio viene creato un oggetto AnalysisHintNode (denominato theAnalysisHint) per l'oggetto InkAnalyzer (denominato theInkAnalyzerWithHint) e theAnalysisHint viene impostato come suggerimento globale rendendo la relativa area infinita. Quindi, vengono impostate le proprietà AllowPartialDictionaryTerms e Name nel suggerimento.

' Add a new, global analysis hint to theInkAnalyzerWithHint.
Dim theAnalysisHint As AnalysisHintNode = Me.theInkAnalyzerWithHint.CreateAnalysisHint()
theAnalysisHint.Location.MakeInfinite()

theAnalysisHint.AllowPartialDictionaryTerms = True
theAnalysisHint.Name = "Allow Partial Dictionary Terms"

// Add a new, global analysis hint to theInkAnalyzerWithHint.
AnalysisHintNode theAnalysisHint =
    this.theInkAnalyzerWithHint.CreateAnalysisHint();
theAnalysisHint.Location.MakeInfinite();

theAnalysisHint.AllowPartialDictionaryTerms = true;
theAnalysisHint.Name = "Allow Partial Dictionary Terms";

Gerarchia di ereditarietà

System.Object
System.Windows.Ink.ContextNode
System.Windows.Ink.AnalysisHintNode

Codice thread safe

Qualsiasi membro static (Shared in Visual Basic) pubblico di questo tipo è thread-safe. I membri di istanza non sono garantiti come thread-safe.

Piattaforme

Windows Vista

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