Passer au contenu principal
Cette méthode est implémentée côté client. Elle est appelée par ABBYY FineReader Engine pour certaines méthodes de l’objet FRPage. Elle transmet au client des informations sur le traitement d’une région.
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 OnRegionProcessed(
  IFRPage*      Sender,
  int           RecognitionPassNumber,
  IRegion*      Region,
  VARIANT_BOOL* Cancel
);

C#

void OnRegionProcessed(
  IFRPage   Sender,
  int      RecognitionPassNumber,
  IRegion   Region,
  ref bool Cancel
);

Visual Basic .NET

Sub OnRegionProcessed( _
  Sender As IFRPage, _
  RecognitionPassNumber As Integer, _
  Region As IRegion, _
  ByRef Cancel As Boolean _
)

Parameters

Sender [in] Ce paramètre fait référence à l’objet FRPage qui envoie les notifications. RecognitionPassNumber [in] Ce paramètre indique le numéro de la passe de reconnaissance. Il peut valoir 0, 1 ou 2. Les rectangles issus de différentes passes peuvent être remplis avec des couleurs différentes, comme c’est le cas dans ABBYY FineReader. Region [in] Ce paramètre fait référence à l’objet Region qui correspond à la région en cours de traitement. Cancel [in, out] Vous pouvez affecter la valeur TRUE à cette variable pour indiquer que le processus doit être interrompu. Dans ce cas, la fonction de traitement retourne 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 cliente de cette méthode doit garantir que toutes les exceptions levées à l’intérieur de la méthode sont interceptées et géré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 (comme l’arrêt du programme).

Voir aussi

IFRPageEvents FRPage