Vai al contenuto principale
Questo metodo è implementato sul lato client. Viene chiamato da ABBYY FineReader Engine prima di cambiare la pagina attiva in Image Viewer. La procedura viene eseguita se la pagina viene cambiata tramite l’interfaccia utente grafica di Image Viewer o di qualsiasi componente sincronizzato. La procedura non viene eseguita se la pagina attiva viene cambiata tramite l’API di Image Viewer o se la pagina attiva è stata eliminata. Il metodo fornisce al client un riferimento alla nuova pagina attiva. Con questo metodo è possibile 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, il che significa che nel documento non è presente alcuna pagina attiva (ad esempio, se tutte le pagine sono state rimosse). Cancel [out] È possibile impostare questa variabile su TRUE per indicare che il processo deve essere terminato. In questo caso, la pagina attiva non verrà modificata.

​
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 questo caso, il valore del parametro Cancel non viene preso in considerazione.

​
Note

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 venga propagata all’esterno del metodo. La propagazione di un’eccezione all’esterno del metodo può causare risultati imprevedibili (come la terminazione del programma).

​
Vedi anche

IImageViewerEvents