Passer au contenu principal
Cette méthode est implémentée côté client. Elle est appelée par ABBYY FineReader Engine par certaines méthodes de l’objet FRDocument. Elle transmet au client des conseils et des avertissements survenus 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 pendant les opérations longues. Cela peut être utile dans les applications dotées d’une interface utilisateur.

​
Syntaxe

​
C++

HRESULT OnWarning(
  IFRDocument*  Sender,
  int           PageIndex,
  BSTR          Warning,
  VARIANT_BOOL* Cancel
);

​
C#

void OnWarning(
  IFRDocument Sender,
  int        PageIndex,
  string     Warning,
  ref bool   Cancel
);

​
Visual Basic .NET

Sub OnWarning( _
  Sender As IFRDocument,  _
  PageIndex As Integer, _
  Warning As String, _
  ByRef Cancel As Boolean _
)

​
Paramètres

Sender [in] Fait référence à l’objet FRDocument qui envoie les notifications. PageIndex [in] Ce paramètre contient l’indice de la page à laquelle se rapporte le conseil ou l’avertissement. Le message peut concerner non seulement une seule page, mais aussi l’ensemble du document. Dans ce cas, la valeur du paramètre est -1. Warning [in] Contient le conseil ou l’avertissement. Cancel [in, out] Vous pouvez définir cette variable sur TRUE pour indiquer que le traitement doit être interrompu. Dans ce cas, la fonction d’analyse ou de reconnaissance qui signale ce message renvoie E_ABORT.

​
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 du 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 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 (tels que l’arrêt du programme).

​
Voir aussi

IFRDocumentEvents FRDocument