Méthode OnEditImages de l’interface IImageViewerEvents
Cette méthode est implémentée côté client. Elle est appelée par ABBYY FineReader Engine avant le début de l’édition d’image dans Image Viewer. Cette opération est déclenchée si l’une des commandes suivantes est exécutée :
Ces commandes peuvent être exécutées à l’aide des boutons correspondants de la barre d’outils (le cas échéant), des éléments du menu contextuel, des touches de raccourci ou de la méthode DoCommand de IImageViewer::Commands. Pour savoir quels moyens sont disponibles pour chaque commande, reportez-vous à la liste Image Viewer Commands.La méthode transmet au client des informations sur les indices des pages qui vont être modifiées, ainsi que sur la commande qui sera utilisée pour l’édition. Cette méthode permet également d’annuler l’opération.
PageIndices[in] Contient les indices des pages à modifier sous la forme d’un objet IntsCollection.MenuItem[in] Spécifie la commande utilisée pour modifier l’image. Voir la description des constantes MenuItemEnum. Les constantes suivantes peuvent être utilisées comme valeur de ce paramètre : MI_DeskewImage, MI_StraightenTextLines, MI_ReduceISONoise, MI_RemoveMotionBlur, MI_RotateClockwise, MI_RotateCounterClockwise, MI_RotateUpsideDown, MI_FlipHorizontal, MI_FlipVertical, MI_InvertImage.Cancel[out] Vous pouvez définir cette variable sur TRUE pour indiquer que le processus doit être interrompu. Dans ce cas, l’image ne sera pas modifiée.
[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 cliente de cette méthode doit garantir que toutes les exceptions levées au sein 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 (comme l’arrêt du programme).