Classe AnalysisHintNode
Aggiornamento: novembre 2007
Fornisce un oggetto InkAnalyzer con un suggerimento di analisi per un'area.
Spazio dei nomi: Microsoft.Ink
Assembly: Microsoft.Ink.Analysis (in Microsoft.Ink.Analysis.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 su un'area specifica, l'oggetto Location del suggerimento, all'oggetto InkAnalyzer a cui è associato. Il suggerimento 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'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 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 i membri di questa classe.
Per aggiungere un suggerimento a un oggetto InkAnalyzer, utilizzare InkAnalyzer.CreateAnalysisHint. Per rimuovere un suggerimento da un oggetto InkAnalyzer, utilizzare DeleteAnalysisHint.
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 ogni volta che 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 collega 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, la presenza di un oggetto AnalysisHintNode denominato theAnalysisHint e di 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 Remove 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 verrà creato o eliminato alcun collegamento da un oggetto AnalysisHintNode a CustomRecognizerNode tramite l'analisi.
In caso di utilizzo di suggerimenti per un'applicazione form, l'applicazione deve evitare di combinare il contesto di testo con l'input penna nei form. Ciò significa, ad esempio, che i nomi dei campi di testo non devono essere creati nella struttura ad albero dell'analisi I suggerimenti costituiscono l'associazione dell'input penna alle aree nelle pagine e qualsiasi contesto di testo interferirà con questa associazione dell'input penna al suggerimento. L'operazione di analisi potrebbe 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, theAnalysisHint, per l'oggetto InkAnalyzer, theInkAnalyzerWithHint, e theAnalysisHint viene impostato come suggerimento globale rendendo la relativa area infinita. Quindi, vengono impostate le proprietà AllowPartialDictionaryTerms e Name del suggerimento.
' Add a new, global analysis hint to theInkAnalyzerWithHint.
Dim theAnalysisHint As Microsoft.Ink.AnalysisHintNode = _
Me.theInkAnalyzerWithHint.CreateAnalysisHint()
theAnalysisHint.Location.MakeInfinite()
theAnalysisHint.AllowPartialDictionaryTerms = True
theAnalysisHint.Name = "Allow Partial Dictionary Terms"
// Add a new, global analysis hint to theInkAnalyzerWithHint.
Microsoft.Ink.AnalysisHintNode theAnalysisHint =
this.theInkAnalyzerWithHint.CreateAnalysisHint();
theAnalysisHint.Location.MakeInfinite();
theAnalysisHint.AllowPartialDictionaryTerms = true;
theAnalysisHint.Name = "Allow Partial Dictionary Terms";
Gerarchia di ereditarietà
System.Object
Microsoft.Ink.ContextNode
Microsoft.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.
Informazioni sulla versione
.NET Framework
Supportato in: 3.0