Méthode OnExportPages 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 du processus d’exportation lancé depuis Document Viewer. Ce processus est lancé lorsqu’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 l’objet IDocumentViewer::Commands. Voir la liste Document Viewer Commands pour plus de détails.La méthode transmet au client des informations sur l’opération d’exportation : le nom et le format du fichier d’exportation, les paramètres d’exportation et les indices des pages à exporter. Cette méthode permet également d’annuler l’opération.
Sub OnActivePageChanging( _ FileName As String, _ Format As FileExportFormatEnum, _ PageIndices As IIntsCollection, _ ExportParams As Object, _ ByRef Cancel As Boolean)
FileName[in] Contient le nom du fichier dans lequel enregistrer les pages.Format[in] Indique le format d’exportation. Voir la description des constantes FileExportFormatEnum.PageIndices[in] Indique les indices des pages d’un document à exporter sous la forme d’un objet IntsCollection.ExportParams[in] Désigne l’objet de paramètres d’exportation du type correspondant au format du fichier d’exportation. Par exemple, si les pages sont enregistrées dans un fichier RTF, il s’agit de l’objet RTFExportParams.Cancel[out] Vous pouvez définir cette variable sur TRUE pour indiquer que le processus doit être arrêté. Dans ce cas, les pages ne seront pas exporté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 cliente de cette méthode doit garantir que toutes les exceptions levées dans la méthode sont interceptées et gérées, et qu’aucune n’est propagée à l’extérieur de celle-ci. La propagation d’une exception hors de la méthode peut entraîner un comportement imprévisible (par exemple, l’arrêt du programme).