Vai al contenuto principale
I Visual Components sono implementati in FRE per Windows.
L’oggetto DocumentViewer è un controllo ActiveX che consente di visualizzare l’elenco delle pagine del documento e di monitorarne lo stato. È inoltre possibile salvare il documento riconosciuto o aprirlo nell’applicazione selezionata utilizzando i comandi disponibili nel componente. Un documento è collegato al componente tramite la proprietà FRDocument. Il componente Document Viewer può avere il seguente aspetto, a seconda del valore della proprietà Mode:
  • Vista dettagliata
Fornisce informazioni dettagliate su ciascuna pagina del documento. DocumentViewer_Details
  • Vista miniature
Visualizza le pagine del documento sotto forma di miniature. DocumentViewer_Thumbnails È possibile modificare l’aspetto del componente tramite le relative proprietà. Ad esempio, è possibile 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, vedere Personalizzazione del menu contestuale e della barra degli strumenti di un componente visivo. Le informazioni sul monitoraggio del documento vengono trasmesse tramite apposite interfacce di uscita. Queste interfacce sono IDocumentViewerEvents (per C++) e la dispinterface DIDocumentViewerEvents (per Visual Basic). Si noti 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. In Visual Basic, questo oggetto può essere dichiarato con WithEvents. Per gli utenti C++, ciò significa che è supportata l’interfaccia IConnectionPointContainer. Per ricevere gli eventi di notifica, un utente C++ deve creare un oggetto derivato dall’interfaccia IDocumentViewerEvents, quindi configurare la connessione tra tale oggetto e l’origine eventi implementata nell’oggetto DocumentViewer tramite i meccanismi COM standard. Il componente Document Viewer può essere collegato al componente Component Synchronizer; in tal caso, tutti gli eventi di Document Viewer verranno trasmessi automaticamente agli altri componenti collegati al Synchronizer e l’intera applicazione funzionerà in modo sincrono.

Proprietà

Specifica la pagina attiva nel Document Viewer. Se non è presente alcuna pagina attiva, il valore di questa proprietà è 0.

Specifica se il riquadro delle didascalie del Document Viewer è abilitato. Se questa proprietà è FALSE, il riquadro delle didascalie non viene visualizzato.

Per impostazione predefinita, il valore è TRUE.

Specifica se il menu contestuale del Document 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 nel Document Viewer. Vederel’elenco dei comandi disponibili nel Document Viewer.

Specifica il documento collegato al Document Viewer.

Specifica se la pagina della lingua del Document Viewer è abilitata. Se questa proprietà è FALSE, la pagina della lingua non viene visualizzata.

Per impostazione predefinita, il valore è TRUE.

Specifica se il Document 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 provenienti da Visual Components 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 al termine dell’operazione. In questo modo, il documento non potrà essere alterato dal Document Viewer.

Per impostazione predefinita, il valore è FALSE.

Specifica la modalità corrente del Document Viewer: visualizzazione Dettagli o Miniature.

Per impostazione predefinita, la modalità è DVM_Thumbnails.

,read-only

Fornisce accesso alle impostazioni del menu contestuale.

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

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

Specifica il titolo del componente Document Viewer.

Per impostazione predefinita, è “Pages”.

,read-only

Fornisce accesso alle impostazioni della barra degli strumenti.

Fornisce accesso alla raccolta degli indici delle pagine selezionate.

Specifica il percorso della cartella contenente i file con le impostazioni di Document 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 è laFineReader Engine data folder. 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, è necessario 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 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.

, di sola lettura

Restituisce l’handle della finestra dell’area client.

Metodi

NomeDescrizione
UpdateOptionsAggiorna le impostazioni specificate nella finestra di dialogo Opzioni di Document Viewer. Potrebbe essere necessario chiamare questo metodo se le opzioni sono state modificate in un altro componente visivo, per aggiornare quelle di Document Viewer in base allo stato corrente.

Esempi

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

Vedi anche

IDocumentViewerEvents IComponentSynchronizer::DocumentViewer Creazione di un’applicazione con interfaccia utente grafica Personalizzazione del menu contestuale e della barra degli strumenti di un componente visivo