Saltar al contenido principal
Este método se implementa del lado del cliente. ABBYY FineReader Engine lo llama antes de cambiar la página activa en Document Viewer. Este proceso se desencadena si la página se cambia mediante la interfaz gráfica de usuario de Document Viewer o de cualquier componente sincronizado. El proceso no se desencadena si la página activa se cambia mediante la API de Document Viewer o si se ha eliminado la página activa. El método proporciona al cliente una referencia a la nueva página activa. Con este método, es posible cancelar la operación.

Sintaxis

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 _
)

Parámetros

Page [in] Hace referencia al objeto FRPage, que contiene la nueva página activa. Este parámetro puede ser NULL, lo que significa que no hay ninguna página activa en el documento (por ejemplo, si se han eliminado todas las páginas). Cancel [out] Puede establecer esta variable en TRUE para indicar que el proceso debe interrumpirse. En este caso, la página activa no cambiará.

Valores de retorno

[Solo para C++] Si este método devuelve un valor distinto de S_OK, significa que se ha producido un error del lado del cliente y, en ese caso, no se tiene en cuenta el valor del parámetro Cancel.

Observaciones

La implementación del cliente de este método debe garantizar que todas las excepciones que se produzcan dentro del método se capturen y se gestionen, y que ninguna se propague fuera de él. La propagación de una excepción fuera del método puede dar lugar a resultados impredecibles (como la finalización del programa).

Consulte también

IDocumentViewerEvents