Vai al contenuto principale
Questo metodo è implementato lato client. Viene chiamato da ABBYY FineReader Engine prima dell’inizio del processo di esportazione avviato da Document Viewer. Il processo viene avviato se viene eseguito uno dei seguenti comandi: I comandi possono essere eseguiti tramite le voci corrispondenti del menu contestuale oppure tramite il metodo DoCommand di IDocumentViewer::Commands. Per ulteriori dettagli, vedere l’elenco Document Viewer Commands. Il metodo fornisce al client informazioni sull’operazione di esportazione: nome e formato del file esportato, parametri di esportazione e indici delle pagine da esportare. Tramite questo metodo è anche possibile annullare l’operazione.

Sintassi

C++

HRESULT OnExportPages(
  BSTR                 FileName,
  FileExportFormatEnum Format,
  IIntsCollection*     PageIndices,
  IUnknown*            ExportParams,
  VARIANT_BOOL*        Cancel
);

C#

void OnExportPages(
  string               FileName,
  FileExportFormatEnum Format,
  IIntsCollection      PageIndices,
  object               ExportParams,
  out bool             Cancel
);

Visual Basic .NET

Sub OnActivePageChanging( _
  FileName As String, _
  Format As FileExportFormatEnum, _
  PageIndices As IIntsCollection, _
  ExportParams As Object, _
  ByRef Cancel As Boolean
)

Parametri

FileName [in] Contiene il nome del file in cui salvare le pagine. Format [in] Specifica il formato di esportazione. Vedere la descrizione delle costanti FileExportFormatEnum. PageIndices [in] Specifica gli indici delle pagine di un documento da esportare come oggetto IntsCollection. ExportParams [in] Fa riferimento all’oggetto dei parametri di esportazione del tipo corrispondente al formato del file di esportazione. Ad esempio, se le pagine vengono salvate in un file RTF, fa riferimento all’oggetto RTFExportParams. Cancel [out] È possibile impostare questa variabile su TRUE per indicare che il processo deve essere interrotto. In tal caso, le pagine non verranno esportate.

Valori di ritorno

[Solo per C++] Se questo metodo restituisce un valore diverso da S_OK, significa che si è verificato un errore lato client e, in tal caso, il valore del parametro Cancel non viene preso in considerazione.

Osservazioni

L’implementazione client di questo metodo deve garantire che tutte le eccezioni generate all’interno del metodo vengano intercettate e gestite e che nessuna eccezione si propaghi all’esterno del metodo. La propagazione di un’eccezione all’esterno del metodo può causare risultati imprevedibili, come la terminazione del programma.

Vedi anche

IDocumentViewerEvents