Vai al contenuto principale
Questo metodo è implementato lato client. Viene chiamato da ABBYY FineReader Engine prima di cambiare la pagina attiva in Text Editor. Il metodo viene richiamato se la pagina viene cambiata tramite l’interfaccia grafica di Text Editor o di qualsiasi componente sincronizzato. Il metodo non viene richiamato se la pagina attiva viene cambiata tramite l’API di Text Editor 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 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 questo caso, il valore del parametro Cancel viene ignorato.

​
Osservazioni

L’implementazione del 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

ITextEditorEvents