Passer au contenu principal
Cette méthode est implémentée côté client. Elle est appelée par ABBYY FineReader Engine lors de l’utilisation de la méthode InjectTextLayer de l’objet Engine. Elle transmet au client les conseils et les avertissements survenus pendant le traitement. 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.

Syntaxe

C++

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

C#

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

Visual Basic .NET

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

Paramètres

PageIndex [in] Ce paramètre contient l’index de la page à laquelle le conseil ou l’avertissement se rapporte. Le message peut se rapporter non seulement à une page en particulier, 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 processus doit être arrêté. Dans ce cas, la fonction de traitement qui signale le 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 veiller à ce que toutes les exceptions levées à l’intérieur de la méthode soient interceptées et traitées, et à ce qu’aucune exception ne soit 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

IProcessingEvents IEngine::InjectTextLayer