Méthode OnEditImages de l’interface IDocumentViewerEvents
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’images dans Document Viewer. Le processus est déclenché si l’une des commandes suivantes est appelée :
Les commandes peuvent être appelées à l’aide des éléments correspondants du menu contextuel ou à l’aide de la méthode DoCommand de IDocumentViewer::Commands. Pour savoir quel mode d’appel est disponible pour chaque commande, consultez la liste Document Viewer Commands.La méthode transmet au client des informations sur la commande qui sera utilisée pour l’édition. Elle permet également d’annuler l’opération.
MenuItem[in] Spécifie la commande à utiliser pour modifier l’image. Voir la description des constantes MenuItemEnum. Les constantes suivantes peuvent être utilisées comme valeur pour ce paramètre : MI_RotateClockwise, MI_RotateCounterClockwise, MI_RotateUpsideDown, MI_FlipHorizontal, MI_FlipVertical.Cancel[out] Vous pouvez définir cette variable sur TRUE pour indiquer que le traitement 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 à l’intérieur de la méthode sont intercepté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).