Vai al contenuto principale
I componenti visivi sono implementati in FRE per Windows.
L’oggetto ZoomViewer è un controllo ActiveX che consente di visualizzare un’immagine ingrandita della riga o dell’area dell’immagine elaborata attualmente in fase di modifica. Mentre Image Viewer mostra la vista generale della pagina, Zoom Viewer offre un modo semplice per visualizzare l’immagine in maggiore dettaglio, regolare la posizione dell’area o confrontare i caratteri incerti con l’immagine ingrandita. Un’immagine viene collegata a Zoom Viewer tramite la proprietà FRPage. Il componente Zoom Viewer ha questo aspetto: ZoomViewer È possibile modificare l’aspetto del componente tramite le relative proprietà. Ad esempio, è possibile modificare il menu contestuale del componente tramite la proprietà Commands. Per ulteriori dettagli, vedere Personalizzazione del menu contestuale e della barra degli strumenti di un componente visivo. Le informazioni sulla visualizzazione di un’immagine vengono fornite tramite speciali interfacce in uscita. Queste interfacce sono IZoomViewerEvents (per C++) e la dispinterface DIZoomViewerEvents (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 offre strumenti semplici per gestirle. Questo oggetto può essere dichiarato con WithEvents in Visual Basic. Per l’utente C++, ciò significa che l’oggetto supporta l’interfaccia IConnectionPointContainer. Per ricevere gli eventi di notifica, un utente C++ deve creare un oggetto derivato dall’interfaccia IZoomViewerEvents, quindi impostare la connessione tra tale oggetto e l’origine eventi implementata nell’oggetto ZoomViewer utilizzando i meccanismi COM standard. Il componente Zoom Viewer può essere collegato al componente Component Synchronizer; in questo caso, tutti gli eventi di Zoom Viewer verranno trasmessi automaticamente agli altri componenti collegati a Synchronizer e l’intera applicazione funzionerà in modo sincrono.

Proprietà

Specifica lo strumento attivo per la modifica di blocchi e immagini.

Specifica se il riquadro inferiore di Zoom Viewer è abilitato. Se questa proprietà è FALSE, il riquadro inferiore non viene visualizzato.

Per impostazione predefinita, il valore è TRUE.

Specifica se il menu contestuale di Zoom Viewer è abilitato. Se questa proprietà è FALSE, il menu contestuale non viene mai visualizzato.

Per impostazione predefinita, il valore è TRUE.

,read-only

Fornisce accesso ai comandi disponibili in Zoom Viewer. Vederel’elenco dei comandi disponibili in Zoom Viewer.

Rappresenta la pagina del documento collegata a Zoom Viewer.

Specifica se Zoom Viewer è bloccato.

Questa proprietà è utile nelle seguenti situazioni:

  • un’operazione di analisi, riconoscimento, sintesi o esportazione viene richiamata da FineReader Engine API (non da Visual Components), oppure
  • l’applicazione riceve notifiche di determinati eventi (ad esempio, dall’oggetto) e gestisce i messaggi Windows provenienti da Visual Components nei relativi 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 su FALSE al termine dell’operazione. In questo modo, il documento non potrà essere alterato da Zoom Viewer.

Per impostazione predefinita, il valore è FALSE.

Specifica i parametri di elaborazione predefiniti per il documento. Questi parametri vengono utilizzati se i processi di analisi e riconoscimento vengono richiamati direttamente da Zoom Viewer.

Se Zoom Viewer è connesso a Component Synchronizer, utilizzare la proprietàIComponentSynchronizer::ProcessingParamsper modificare i parametri utilizzati per l’elaborazione. Se si modificano i parametri di elaborazione tramite la proprietà di Zoom Viewer, potrebbero verificarsi errori.

Specifica il percorso della cartella contenente i file con le impostazioni di Zoom Viewer. Gli altri Visual Components dispongono della stessa proprietà. Ogni Visual Component deve utilizzare la propria cartella per le impostazioni.

Il valore di questa proprietà è composto dal percorso della cartella in cui ABBYY FineReader Engine archivia i dati specifici dell’utente e dal nome della relativa 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 la funzione, o tramite il metodo). Il nome predefinito della sottocartella è un GUID arbitrario. Per modificare il nome della sottocartella, è necessario specificare il nuovo nome in le proprietà del componente in Visual Studio in fase di progettazione. Se si tenta di specificare il valore della proprietà in fase di esecuzione, tale valore viene ignorato.

Se si aggiunge il componente 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 il componente viene generato dinamicamente in fase di esecuzione), il componente crea una nuova cartella con le impostazioni ogni volta che viene inizializzato. Per evitare la proliferazione delle cartelle, è necessario eliminare la cartella delle impostazioni creata dopo la deinizializzazione 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.

Memorizza le coordinate del rettangolo del carattere corrente in pixel. Le coordinate sono relative all’immagine del documento.

Specifica se il carattere corrente deve essere contrassegnato con un rettangolo giallo.

Per impostazione predefinita, il valore è TRUE.

Specifica la scala dell’immagine in punti percentuali. Questa proprietà può essere impostata anche su una delle costanti.

Per impostazione predefinita, il valore è ST_PixelToPixel, il che significa che l’immagine viene visualizzata in modalità pixel per pixel.

,di sola lettura

Memorizza le coordinate dell’area del documento visibile in pixel. Le coordinate sono relative all’immagine del documento.

, di sola lettura

Restituisce l’handle della finestra dell’area client.

Metodi

NomeDescrizione
CenterOnDocumentPointScorre la vista zoom in modo che il punto specificato venga posizionato al centro della vista.
DocumentToScreenConverte le coordinate del punto specificato sull’immagine del documento in coordinate dello schermo.
GetSelectedBlocksIndicesRestituisce la raccolta di indici dei blocchi selezionati.
GetSelectedCellsRestituisce il rettangolo che racchiude le celle selezionate nel blocco tabella specificato.
ScreenToDocumentConverte le coordinate sullo schermo del punto specificato in coordinate sull’immagine del documento.
SetSelectedBlocksIndicesImposta la selezione dei blocchi.
SetSelectedCellsImposta le celle selezionate del blocco tabella specificato.
ShowDocumentAreaScorre la vista zoom in modo da rendere visibile, per quanto possibile, l’area del documento con le coordinate specificate.
UpdateOptionsAggiorna le impostazioni specificate nella finestra di dialogo Options di Zoom Viewer. Potrebbe essere necessario chiamare questo method se le opzioni sono state modificate in un altro componente visivo, per aggiornare le opzioni di Zoom Viewer allo stato corrente.

Esempi

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

Vedi anche

IZoomViewerEvents IComponentSynchronizer::ZoomViewer Creare un’applicazione con interfaccia utente grafica Personalizzare il menu contestuale e la barra degli strumenti di un componente visivo