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 Text Editor. Ce traitement est déclenché lorsque la page est modifiée via l’interface utilisateur graphique de Text Editor ou de tout composant synchronisé. Il n’est pas déclenché si la page active est modifiée via l’API de Text Editor ou si la page active a été supprimée. La méthode fournit au client une référence à la nouvelle page active. À l’aide de cette méthode, il est possible 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] Désigne l’objet FRPage, qui contient la nouvelle page active. Ce paramètre peut être NULL, ce qui signifie qu’il n’y a aucune 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 côté client 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 hors de la méthode. La propagation d’une exception hors de la méthode peut entraîner des résultats imprévisibles (par exemple, l’arrêt du programme).

​
Voir aussi

ITextEditorEvents