Passer au contenu principal
Cette méthode est implémentée côté client. Elle est appelée par ABBYY FineReader Engine pour certaines des méthodes de l’objet FRPage. Elle transmet au client les conseils et avertissements générés pendant le traitement.
Sous Windows, elle peut également traiter les messages système afin d’éviter que l’application ne semble ne plus répondre lors d’opérations longues. Cela peut être utile dans les applications dotées d’une interface utilisateur.

Syntaxe

C++

HRESULT OnWarning(
  IFRPage*      Sender,
  BSTR          Warning,
  VARIANT_BOOL* Cancel
);

C#

void OnWarning(
  IFRPage   Sender,
  string   Warning,
  ref bool Cancel
);

Visual Basic .NET

Sub OnWarning( _
  Sender As IFRPage, _
  Warning As String, _
  ByRef Cancel As Boolean _
)

Paramètres

Sender [in] Fait référence à l’objet FRPage qui envoie les notifications. Warning [in] Contient le conseil ou l’avertissement. Cancel [in, out] Vous pouvez définir cette variable sur TRUE pour indiquer que le processus doit être interrompu. Dans ce cas, la fonction de traitement qui signale ce conseil renvoie E_ABORT.

Valeurs de retour

[C++ uniquement] Si cette méthode renvoie une valeur autre que S_OK, cela signifie 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 ne se propage à l’extérieur de la méthode. La propagation d’une exception hors de la méthode peut entraîner des résultats imprévisibles (comme l’arrêt du programme).

Voir aussi

IFRPageEvents FRPage