Méthode OnCorrectPerspective de l’interface IImageViewerEvents
Cette méthode est implémentée côté client. Elle est appelée par ABBYY FineReader Engine avant la correction des distorsions de perspective sur des pages d’image dans Image Viewer. Le processus est lancé lorsque l’on clique sur le bouton Correct this image dans la section Correct Trapezium Distortions de la boîte de dialogue Image Editor.La méthode transmet au client l’index de la page qui va être modifiée, ainsi que les coordonnées des nouveaux coins de la page. Cette méthode permet également d’annuler l’opération.
Sub OnCorrectPerspective( _ PageIndex As Integer, _ TopLeft As IPoint, _ TopRight As IPoint, _ BottomRight As IPoint, _ BottomLeft As IPoint, _ ByRef Cancel As Boolean _)
PageIndex[in] Contient l’indice de la page pour laquelle les distorsions trapézoïdales doivent être corrigées.TopLeft[in] Contient les coordonnées du point de l’image qui deviendra le nouveau coin supérieur gauche de l’image corrigée. Voir la description de l’objet Point.TopRight[in] Contient les coordonnées du point de l’image qui deviendra le nouveau coin supérieur droit de l’image corrigée. Voir la description de l’objet Point.BottomRight[in] Contient les coordonnées du point de l’image qui deviendra le nouveau coin inférieur droit de l’image corrigée. Voir la description de l’objet Point.BottomLeft[in] Contient les coordonnées du point de l’image qui deviendra le nouveau coin inférieur gauche de l’image corrigée. Voir la description de l’objet Point.Cancel[out] Vous pouvez définir cette variable sur TRUE pour indiquer que le processus doit être arrêté. Dans ce cas, les distorsions de perspective ne seront pas corrigées.
[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.
L’implémentation côté client de cette méthode doit garantir que toutes les exceptions levées dans la méthode sont capturées et géré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 (comme l’arrêt du programme).