Metodo InkRecognizer.SetAsHighestPriorityInkRecognizer
Aggiornamento: novembre 2007
Imposta questo oggetto InkRecognizer sulla priorità più elevata nell'elenco ordinato interno InkAnalyzer dei sistemi di riconoscimento.
Spazio dei nomi: Microsoft.Ink
Assembly: Microsoft.Ink.Analysis (in Microsoft.Ink.Analysis.dll)
Sintassi
'Dichiarazione
Public Sub SetAsHighestPriorityInkRecognizer
'Utilizzo
Dim instance As InkRecognizer
instance.SetAsHighestPriorityInkRecognizer()
public void SetAsHighestPriorityInkRecognizer()
public:
void SetAsHighestPriorityInkRecognizer()
public void SetAsHighestPriorityInkRecognizer()
public function SetAsHighestPriorityInkRecognizer()
Note
Ogni sistema di riconoscimento contiene i valori che descrivono le lingue e le funzionalità supportate. Organizzando i sistemi di riconoscimento disponibili in un elenco ordinato, l'oggetto InkAnalyzer può determinare quale sistema di riconoscimento utilizzare se due o più sistemi di riconoscimento supportano la stessa lingua e le stesse funzionalità. InkAnalyzer archivierà un elenco ordinato interno di sistemi di riconoscimento. L'elenco ordinato interno sarà compilato dinamicamente ogni volta che viene chiamato.
Nota
Se le prestazioni sono lente a causa dell'accesso al Registro di sistema, è possibile applicare una limitazione che consente la verifica dei valori del Registro di sistema solo quando viene creato l'oggetto InkAnalyzer.
L'elenco interno sarà ordinato in base alla logica seguente:
Verificare se l'applicazione Pannello di controllo ha impostato un ordine analizzando i valori della chiave del Registro di sistema "Recognizers Precedence":
"HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\TPG\Recognizers Precedence"
Ogni sistema di riconoscimento viene elencato per GUID come una sottochiave del Registro di sistema.
Ogni sottochiave del Registro di sistema dispone di un valore dword definito "Ordine" che è un ordine in base zero (0=primo sistema di riconoscimento da utilizzare, 1 = secondo sistema di riconoscimento da utilizzare… n = ultimo sistema di riconoscimento da utilizzare).
Se la chiave "Recognizers Precedence" non esiste o è danneggiata, procedere semplicemente al passaggio successivo.
Verificare se tutti i sistemi di riconoscimento Microsoft installati sono rappresentati nell'elenco ordinato controllando le chiavi del Registro di sistema "System Recognizer". Qualsiasi sistema di riconoscimento Microsoft individuato nel sistema, ma non incluso nell'elenco ordinato, sarà aggiunto alla fine dell'elenco, in base all'ordine di individuazione.
Verificare se tutti i sistemi di riconoscimento esterni (di terze parti) installati sono rappresentati nell'elenco ordinato controllando le chiavi del Registro di sistema "Recognizer". Qualsiasi sistema di riconoscimento esterno individuato nel sistema, ma non incluso nell'elenco ordinato sarà aggiunto alla fine dell'elenco, in base all'ordine di individuazione.
Una volta compilato l'ordinamento predefinito, le applicazioni possono cambiare o eseguire l'override dell'ordinamento predefinito chiamando questo metodo e promuovendo un sistema di riconoscimento nella parte superiore dell'elenco.
L'utilizzo di sistemi di riconoscimento sarà valutato in base al relativo ordine nell'elenco:
Il parser si avvierà con il primo sistema di riconoscimento dell'elenco.
Il primo sistema di riconoscimento sarà testato per verificare se supporta la lingua e le funzionalità dell'input penna in corso di riconoscimento.
Se tali elementi sono supportati, il sistema di riconoscimento viene utilizzato.
In caso contrario, viene verificato il sistema di riconoscimento successivo nell'elenco. Lo scorrimento dell'elenco continua finché non viene individuato un sistema di riconoscimento o non viene terminato l'elenco.
Se non viene individuato nessun sistema di riconoscimento, viene restituita l'eccezione TPG_No_Suitable_Recognizer_Found.
Esempi
In questo esempio, viene esaminato ogni oggetto InkRecognizer disponibile in un oggetto InkAnalyzer. Se l'oggetto InkRecognizer supporta l'ID lingua 1031 (tedesco), viene impostato come sistema di riconoscimento con la massima priorità.
Dim allInkRecognizers As InkRecognizerCollection = mInkAnalyzer.GetInkRecognizersByPriority()
For Each IR As InkRecognizer In allInkRecognizers
For Each langID As Integer In IR.GetLanguages()
If langID = 1031 Then
IR.SetAsHighestPriorityInkRecognizer()
End If
Next
Next
InkRecognizerCollection allInkRecognizers = mInkAnalyzer.GetInkRecognizersByPriority();
foreach (InkRecognizer IR in allInkRecognizers)
{
foreach(int langID in IR.GetLanguages())
{
if (langID == 1031)
{
IR.SetAsHighestPriorityInkRecognizer();
}
}
}
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