Vai al contenuto principale
I Visual Components sono implementati in FRE per Windows.
L’oggetto ImageViewer è un controllo ActiveX che consente di visualizzare e modificare un’immagine e i blocchi presenti nell’immagine. Un’immagine è collegata a Image Viewer tramite la proprietà FRPage. Il componente Image Viewer si presenta così: ImageViewer Puoi modificare l’aspetto del componente tramite le sue proprietà. Ad esempio, puoi aggiungere pulsanti alla barra degli strumenti e rimuoverli tramite la proprietà Toolbar, oppure modificare il menu contestuale del componente tramite la proprietà PopupMenu. Per ulteriori dettagli, vedi Personalizzazione del menu contestuale e della barra degli strumenti di un componente visivo. Le informazioni sulla visualizzazione e la modifica dell’immagine vengono fornite tramite apposite interfacce in uscita. Queste interfacce sono IImageViewerEvents (per C++) e la dispinterface DIImageViewerEvents (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 WithEvents in Visual Basic. Per gli utenti C++, questo significa che è supportata l’interfaccia IConnectionPointContainer. Per ricevere gli eventi di notifica, un utente C++ deve creare un oggetto derivato dall’interfaccia IImageViewerEvents, quindi stabilire la connessione tra tale oggetto e l’origine eventi implementata nell’oggetto ImageViewer tramite i meccanismi COM standard. Il componente Image Viewer può essere collegato al componente Component Synchronizer; in questo caso, tutti gli eventi di Image Viewer verranno automaticamente trasmessi agli altri componenti collegati al Synchronizer e l’intera applicazione funzionerà in modo sincrono.

Proprietà

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

Specifica se Image Viewer deve scorrere tutte le pagine del documento. Se questa proprietà è FALSE, Image Viewer scorre solo la pagina selezionata.

Per impostazione predefinita, il valore è TRUE.

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

Per impostazione predefinita, il valore è TRUE.

Specifica se il riquadro della didascalia di Image Viewer è abilitato. Se questa proprietà è FALSE, il riquadro della didascalia non viene visualizzato.

Per impostazione predefinita, il valore è TRUE.

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

Per impostazione predefinita, il valore è TRUE.

,di sola lettura

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

Specifica la pagina del documento collegata a Image Viewer.

Specifica se i frammenti riconosciuti devono essere evidenziati sull’immagine durante il riconoscimento. Questa proprietà consente di monitorare l’avanzamento del riconoscimento.

Per impostazione predefinita, il valore è TRUE.

Specifica se Image Viewer è bloccato.

Questa proprietà è utile nelle seguenti situazioni:

  • un’operazione di analisi, riconoscimento, sintesi o esportazione viene richiamata dall’API di FineReader Engine (non da Visual Components), oppure
  • l’applicazione riceve notifiche di determinati eventi (ad esempio, dall’oggetto) e gestisce i messaggi Windows di 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 può essere danneggiato da Image Viewer.

Per impostazione predefinita, il valore è FALSE.

,read-only

Fornisce accesso alle impostazioni del menu contestuale.

Specifica i parametri di elaborazione predefiniti per un documento. Questi parametri vengono utilizzati se i processi di analisi, riconoscimento e sintesi vengono richiamati direttamente da Image Viewer.

Se Image 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 Image Viewer, potrebbero verificarsi degli errori.

Fornisce accesso alla raccolta degli indici delle pagine selezionate nella finestra di dialogo Image Editor.

Specifica il percorso della cartella che contiene i file con le impostazioni di Image Viewer. Gli altri componenti visivi dispongono della stessa proprietà. Ogni componente visivo 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. 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à in fase di esecuzione, tale valore viene ignorato.

Se si aggiunge il componente a un modulo 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, sarà possibile utilizzare solo le impostazioni predefinite del componente e non sarà possibile salvare le impostazioni tra una sessione e l’altra.

Specifica il titolo del componente Image Viewer.

Per impostazione predefinita, è “Image”.

,read-only

Fornisce accesso alle impostazioni della barra degli strumenti.

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

Per impostazione predefinita, il valore è ST_BestFit, che indica la selezione automatica della migliore adattabilità.

,read-only

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.

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

Specifica se l’area di zoom deve essere contrassegnata sull’immagine con un rettangolo tratteggiato.

Per impostazione predefinita, il valore è TRUE.

Metodi

NomeDescrizione
CenterOnDocumentPointScorre la visualizzazione dell’immagine 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 degli indici dei blocchi selezionati.
GetSelectedCellsRestituisce il rettangolo che racchiude le celle selezionate nel blocco tabella specificato.
PrintStampa l’immagine.
ScreenToDocumentConverte le coordinate dello 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 visualizzazione dell’immagine in modo che l’area del documento con le coordinate specificate diventi visibile, per quanto possibile.
UpdateOptionsAggiorna le impostazioni specificate nella finestra di dialogo Options di Image Viewer. Potrebbe essere necessario chiamare questo metodo se le opzioni sono state modificate in un altro componente visivo, per aggiornare le opzioni di Image Viewer allo stato corrente.

Esempi

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

Vedi anche

IImageViewerEvents IComponentSynchronizer::ImageViewer Creazione di un’applicazione con interfaccia utente grafica Personalizzazione del menu contestuale e della barra degli strumenti di un componente visivo Lavorare con le proprietà