Passer au contenu principal
Cette méthode est implémentée côté client. Elle est appelée par ABBYY FineReader Engine avant le changement de la page active dans Document Viewer. Le processus est déclenché si la page est modifiée via l’interface utilisateur graphique de Document Viewer ou d’un composant synchronisé. Le processus n’est pas déclenché si la page active est modifiée via l’API de Document Viewer ou si la page active a été supprimée. La méthode transmet au client une référence vers la nouvelle page active et 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 _
)

​
Parameters

Page [in] Fait référence à l’objet FRPage qui contient la nouvelle page active. Ce Parameter 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 arrêté. Dans ce cas, la page active ne sera pas modifiée.

​
Valeurs de retour

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

​
Remarques

L’implémentation client de cette méthode doit garantir que toutes les exceptions levées au sein de la méthode sont interceptées et gérées, et qu’aucune exception ne se propage en dehors de celle-ci. La propagation d’une exception en dehors de la méthode peut entraîner des résultats imprévisibles (tels que l’arrêt du programme).

​
Voir aussi

IDocumentViewerEvents