Vai al contenuto principale
Questo metodo è implementato lato client. Viene chiamato da ABBYY FineReader Engine prima di cambiare la pagina attiva in Document Viewer. Il metodo viene chiamato se la pagina viene cambiata tramite l’interfaccia utente grafica di Document Viewer o di qualsiasi componente sincronizzato. Non viene chiamato se la pagina attiva viene cambiata tramite l’API di Document Viewer o se la pagina attiva è stata eliminata. Il metodo passa al client un riferimento alla nuova pagina attiva. Questo metodo consente di annullare l’operazione.

​
Sintassi

​
C++

HRESULT OnActivePageChanging(
  IFRPage*      Page,
  VARIANT_BOOL* Cancel
);

​
C#

void OnActivePageChanging(
  IFRPage   Page,
  out bool Cancel
);

​
Visual Basic .NET

Sub OnActivePageChanging( _
  Page As IFRPage, _
  ByRef Cancel As Boolean _
)

​
Parametri

Page [in] Fa riferimento all’oggetto FRPage, che contiene la nuova pagina attiva. Questo parametro può essere NULL, a indicare che nel documento non è presente alcuna pagina attiva (ad esempio, se tutte le pagine sono state eliminate). Cancel [out] È possibile impostare questa variabile su TRUE per indicare che il processo deve essere interrotto. In questo caso, la pagina attiva non verrà modificata.

​
Valori di ritorno

[Solo 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 venga propagata all’esterno del metodo. La propagazione di un’eccezione all’esterno del metodo può causare risultati imprevedibili, fino alla terminazione del programma.

​
Vedi anche

IDocumentViewerEvents