Passer au contenu principal
Cette méthode est implémentée côté client. Elle est appelée par ABBYY FineReader Engine avant de modifier la page active dans Image Viewer. Le processus est déclenché lorsque la page est modifiée via l’interface utilisateur graphique d’Image Viewer ou de tout composant synchronisé. Le processus n’est pas déclenché si la page active est modifiée via l’API d’Image Viewer ou si la page active a été supprimée. La méthode fournit au client une référence à la nouvelle page active. Cette méthode permet d’annuler l’opération.

​
Syntaxe

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

​
Paramètres

Page [in] Fait référence à l’objet FRPage, qui contient la nouvelle page active. Ce paramètre peut être NULL, ce qui signifie qu’il n’y a pas de page active dans le document (par exemple, si toutes les pages ont été supprimées). Cancel [out] Vous pouvez définir cette variable sur TRUE pour indiquer que le processus doit être interrompu. Dans ce cas, la page active ne sera pas modifiée.

​
Valeurs de retour

[C++ uniquement] Si cette méthode renvoie une valeur autre que S_OK, cela indique qu’une erreur s’est produite côté client et, dans ce cas, la valeur du paramètre Cancel n’est pas prise en compte.

​
Remarques

L’implémentation cliente de cette méthode doit garantir que toutes les exceptions levées à l’intérieur de la méthode sont interceptées et traitées, et qu’aucune exception n’est propagée en dehors de la méthode. La propagation d’une exception en dehors de la méthode peut entraîner des résultats imprévisibles (comme l’arrêt du programme).

​
Voir aussi

IImageViewerEvents