Vai al contenuto principale
I componenti visivi sono implementati in FRE per Windows.
L’oggetto TextValidator è un controllo ActiveX che consente di verificare i caratteri di un documento riconosciuti in modo incerto. Il documento è collegato al componente tramite la proprietà FRDocument. Il componente Text Validator può avere un aspetto simile al seguente: TextValidator Per i testi con direzione di scrittura verticale:
TextValidator_CJK
Per avviare il controllo ortografico, è necessario chiamare il metodo Spell o SpellBlock dell’oggetto TextValidator. Se il controllo ortografico è già in corso, occorre prima interromperlo, altrimenti le nuove chiamate a questi metodi verranno ignorate.
  • È anche possibile avviare il controllo ortografico usando il pulsante Check Spelling in Text Editor.
  • Alcuni caratteri di lingue con scritture complesse (ad esempio cinese, thai, armeno) potrebbero non essere visualizzati in Text Validator se il font usato in Text Validator non include i caratteri corrispondenti. In questo caso, è possibile specificare un altro font nella finestra di dialogo Options (in Text Validator fare clic su Settings > Options, aprire la scheda View e selezionare il font nell’elenco a discesa Font used to display plain text).
Le informazioni sul controllo ortografico vengono trasmesse tramite speciali interfacce in uscita. Queste interfacce sono ITextValidatorEvents (per C++) e la dispinterface DITextValidatorEvents (per Visual Basic). Vale la pena notare che gli utenti di Visual Basic non devono preoccuparsi dei dettagli di implementazione delle interfacce evento, poiché questa piattaforma di sviluppo fornisce strumenti semplici per gestirle. Questo oggetto può essere dichiarato con WithEvents in Visual Basic. Per un utente C++, ciò significa che supporta l’interfaccia IConnectionPointContainer. Per ricevere gli eventi di notifica, un utente C++ deve creare un oggetto derivato dall’interfaccia ITextValidatorEvents, quindi configurare la connessione tra tale oggetto e l’origine eventi implementata nell’oggetto TextValidator tramite i meccanismi COM standard. Il componente Text Validator può essere collegato al componente Component Synchronizer; in questo caso, tutti gli eventi di Text Validator verranno trasmessi automaticamente agli altri componenti collegati al Synchronizer e l’intera applicazione funzionerà in modo sincrono.

Proprietà

,di sola lettura

Rappresenta una raccolta di parole aggiunte a un dizionario da un utente durante il controllo ortografico.

Se le parole vengono aggiunte a un dizionario durante il controllo ortografico, il dizionario utente viene creato nella cartella specificata dallaILanguageDatabase::DictionaryExtensionsPathproprietà.

Rappresenta una raccolta di coppie di parole. La prima parola della coppia è la parola originale che viene sostituita automaticamente durante il controllo ortografico, la seconda è la sostituzione.

Specifica se il Validatore di testo deve correggere gli spazi durante il controllo ortografico. Se il valore di questa proprietà viene impostato su TRUE, il Validatore di testo correggerà gli spazi prima o dopo i segni di punteggiatura.

Per impostazione predefinita, il valore è FALSE.

Rappresenta una raccolta di parole che devono essere ignorate durante il controllo ortografico.

, di sola lettura

Specifica se il controllo ortografico è in corso.

Rappresenta il documento connesso al Validatore di testo.

Specifica se il Validatore di testo è bloccato.

Questa proprietà è utile nelle seguenti situazioni:

  • un’operazione di analisi, riconoscimento, sintesi o esportazione viene chiamata dall’API di FineReader Engine (non dai Componenti visivi), o
  • la vostra applicazione riceve notifiche di determinati eventi (ad es., dall’oggetto) ed elabora i messaggi di Windows dai Componenti visivi in questi gestori di eventi.

In questo caso, si consiglia di impostare questa proprietà su TRUE prima dell’analisi, del riconoscimento, della sintesi o dell’esportazione e di impostarla su FALSE dopo la fine dell’operazione. In questo caso, il documento non può essere alterato dal Validatore di testo.

Per impostazione predefinita, il valore è FALSE.

Rappresenta una raccolta di coppie di parole. La prima parola della coppia è la parola originale che viene sostituita durante il controllo ortografico, la seconda è la sostituzione.

Specifica il percorso della cartella che contiene i file con le impostazioni del Validatore di testo. Altri Componenti visivi hanno la stessa proprietà. Ogni Componente visivo dovrebbe utilizzare la propria cartella con le impostazioni.

Il valore di questa proprietà è costruito dal percorso della cartella, in cui ABBYY FineReader Engine memorizza i dati specifici dell’utente, e dal nome della sua sottocartella. Per impostazione predefinita, la cartella con i dati specifici dell’utente è lacartella dati di FineReader Engine. Può essere modificata durante l’inizializzazione di FineReader Engine (tramite lafunzione, o tramite ilmetodo). Il nome predefinito della sottocartella è un GUID arbitrario. Per modificare il nome della sottocartella, specificare il nuovo nome nelle proprietà del componente in Visual Studio in fase di progettazione. Se si tenta di specificare il valore della proprietà durante l’esecuzione, tale valore viene ignorato.

Se il componente viene aggiunto a un form in Visual Studio durante la progettazione, il valore della proprietà viene definito automaticamente con il valore predefinito oppure manualmente con un valore personalizzato. In entrambi i casi il valore viene definito in fase di progettazione. Se per qualche motivo il valore della proprietà non è definito in fase di progettazione (ad esempio, se si genera il componente dinamicamente durante l’esecuzione), il componente crea una nuova cartella con le impostazioni ogni volta che il componente viene inizializzato. Per evitare la proliferazione delle cartelle, eliminare la cartella delle impostazioni creata dopo la disinizializzazione del componente. In questo caso, è possibile utilizzare solo le impostazioni predefinite del componente e non è possibile salvare le impostazioni tra una sessione e l’altra.

Specifica se Text Validator deve fermarsi sulle parole composte durante il controllo ortografico.

Per impostazione predefinita, il valore è FALSE.

Specifica se Text Validator deve fermarsi sulla spazzatura durante il controllo ortografico. La spazzatura è una combinazione di caratteri priva di senso.

Per impostazione predefinita, il valore è FALSE.

Specifica se Text Validator deve fermarsi sulle parole non presenti nel dizionario durante il controllo ortografico. Questa proprietà e la StopAtUncertain proprietà non possono essere impostate su FALSE contemporaneamente.

Per impostazione predefinita, il valore è TRUE.

Specifica se Text Validator deve fermarsi sui caratteri riconosciuti in modo incerto durante il controllo ortografico. Questa proprietà e la StopAtNonDictionary proprietà non possono essere impostate su FALSE contemporaneamente.

Per impostazione predefinita, il valore è TRUE.

,read-only

Rappresenta una raccolta di parole suggerite per correggere l’ortografia delle parole riconosciute in modo incerto durante il controllo ortografico.

Specifica i parametri di sintesi predefiniti per un documento. Questi parametri vengono usati se Text Validator deve eseguire la sintesi del documento (questo può verificarsi se la struttura logica di un documento risulta errata a causa di alcune operazioni di modifica).

Se Text Validator è collegato a Component Synchronizer, utilizzare laIComponentSynchronizer::ProcessingParamsproprietà per modificare i parametri usati per la sintesi del documento. Se si modificano questi parametri tramite la proprietà di Text Validator, potrebbero verificarsi errori.

,read-only

Rappresenta la posizione di un carattere incerto o di una parola incerta.

, di sola lettura

Restituisce il handle della finestra dell’area client.

Metodi

NomeDescrizione
EndSpellingInterrompe il controllo ortografico.
SpellAvvia il controllo ortografico dalla posizione specificata.
SpellBlockControlla l’ortografia nel blocco specificato.
UpdateOptionsAggiorna le impostazioni specificate in Options di Text Validator. Potrebbe essere necessario richiamare questo metodo se le opzioni sono state modificate in un altro Componente visivo, per aggiornarle allo stato corrente.

Esempi

Questo componente viene usato nei seguenti esempi di codice: VisualComponents.

Vedi anche

ITextValidatorEvents IComponentSynchronizer::TextValidator Creazione di un’applicazione con interfaccia utente grafica