ABBYY FineReaderEngine

Guide d’utilisation – Partie 2

Ce tutoriel est la deuxième partie d’une série qui se charge de vous apprendre à utiliser certaines fonctionnalités du kit de développement ABBYY FineReaderEngine. 2 commentaires

Article lu fois.

L'auteur

ABBY

L'article

Publié le 6 octobre 2020

Version PDF Version hors-ligne

ePub, Azw et Mobi

Liens sociaux

I. Méthode DocumentToScreen de l'objet ZoomViewer▲

Cette méthode convertit les coordonnées du point spécifié sur l'image du document en coordonnées d'écran.

I-A. Syntaxe▲

cpp

Sélectionnez

HRESULT DocumentToScreen( 
int DocumentX, 
int DocumentY, 
int* ScreenX, 
int* ScreenY 
);

Sélectionnez

void DocumentToScreen( 
int DocumentX, 
int DocumentY, 
out int ScreenX, 
out int ScreenY 
);

Sélectionnez

Sub DocumentToScreen( _ 
DocumentX As Integer, _ 
DocumentY As Integer, _
ByRef ScreenX As Integer, _ 
ByRef ScreenY As Integer _ 
)

I-B. Paramètres▲

DocumentX
[in] Spécifie la coordonnée horizontale du point sur l'image du document.
DocumentY
[in] Spécifie la coordonnée verticale du point sur l'image du document.
ScreenX
[out] Reçoit la coordonnée horizontale du point en coordonnées d'écran.
ScreenY
[out] Reçoit la coordonnée verticale du point en coordonnées d'écran.

I-C. Valeurs de retour▲

Cette méthode n'a pas de valeurs de retour spécifiques. Elle renvoie les valeurs de retour standard d’ABBYY FineReader Engine functions.

II. Méthode GetSelectedBlocksIndices de l'objet ZoomViewer▲

Cette méthode retourne la collecte des indices des blocs sélectionnés.

II-A. Syntaxe▲

cpp

Sélectionnez

HRESULT GetSelectedBlocksIndices( IIntsCollection** indices );

Sélectionnez

GetSelectedBlocksIndices();

II-B. Paramètres▲

Indices

[out, retval] Donne accès à l'objet IntsCollection qui contient les index des blocs.

II-C. Valeurs de retour▲

Cette méthode n'a pas de valeurs de retour spécifiques. Elle renvoie les valeurs de retour standard d'ABBYY FineReader Engine functions.

III. Méthode GetSelectedCells de l'objet ZoomViewer▲

Cette méthode renvoie le rectangle environnant des cellules sélectionnées dans le bloc tableau spécifié.

III-A. Syntaxe▲

C++

Sélectionnez

HRESULT GetSelectedCells( 
int blockIndex, 
IFRRectangle** selectedCells 
);

Sélectionnez

IFRRectangle GetSelectedCells( int blockIndex );

Visual Basic .Net

Sélectionnez

Function GetSelectedCells(blockIndex As Integer) As IFRRectangle

III-B. Paramètres▲

blockIndex

[in] Spécifie l'index d'un bloc de table. L'index se trouve dans la collection ILayout::VisualBlocks .

selectedCells

[out, retval] Donne accès à l'objet FRRectangle retourné qui contient les coordonnées du rectangle qui entoure les cellules sélectionnées. Les coordonnées sont définies dans une grille de base.

III-C. Valeurs de retour▲

Cette méthode n'a pas de valeurs de retour spécifiques. Elle renvoie les valeurs de retour standard d’ABBYY FineReader Engine functions.

Remarques

Par grille de base, nous entendons ici la grille formée par les bordures et les séparateurs des tableaux. Chaque verticale incrémente la coordonnée horizontale d'une unité, et chaque séparateur horizontal incrémente les coordonnées verticales par un. Les axes de coordonnées sont orientés de gauche à droite et de haut en bas.

IV. Méthode ScreenToDocument de l'objet ZoomViewer▲

Cette méthode convertit les coordonnées d'écran du point spécifié en coordonnées sur l'image du document.

IV-A. Syntaxe▲

C++

Sélectionnez

HRESULT ScreenToDocument( 
int ScreenX, 
int ScreenY, 
int* DocumentX, 
int* DocumentY 
);

Sélectionnez

void ScreenToDocument( 
int ScreenX, 
int ScreenY, 
out int DocumentX, 
out int DocumentY 
);

Visual Basique .Net

Sélectionnez

Sub ScreenToDocument( 
ScreenX As Integer, _ 
ScreenY As Integer, _ 
ByRef DocumentX As Integer, _ 
ByRef DocumentY As Integer _ 
)

V. Paramètres▲

ScreenX
[in] Spécifie la coordonnée horizontale du point en coordonnées d'écran.
ScreenY
[in] Spécifie la coordonnée verticale du point en coordonnées d'écran.
DocumentX
[out] Reçoit la coordonnée horizontale du point sur l'image du document.
DocumentY
[out] Reçoit la coordonnée verticale du point sur l'image du document.

V-A. Valeurs de retour▲

Cette méthode n'a pas de valeurs de retour spécifiques. Elle renvoie les valeurs de retour standard d’ABBYY FineReader Engine functions.

VI. Méthode SetSelectedBlocksIndices de l'objet ZoomViewer▲

Cette méthode vous permet de définir la sélection des blocs.

VI-A. Syntax▲

C++

Sélectionnez

HRESULT SetSelectedBlocksIndices( IIntsCollection* indices );

Sélectionnez

void SetSelectedBlocksIndices( IIntsCollection indices );

Visual basique .Net

Sélectionnez

Sub SetSelectedBlocksIndices(indices As IntsCollection)

VI-B. Paramètres▲

indices

[in] Fait référence à l'objet IntsCollection qui contient l'ensemble des indices des blocs à sélectionner.

VI-C. Valeurs de retour▲

Cette méthode n'a pas de valeurs de retour spécifiques. Elle renvoie les valeurs de retour standard d'ABBYY FineReader Engine functions.

VI-D. Méthode SetSelectedCells de l'objet ZoomViewer▲

Cette méthode vous permet de définir des cellules sélectionnées d'un bloc tableau.

VI-E. Syntax▲

Sélectionnez

HRESULT SetSelectedCells( 
int blockIndex, 
IFRRectangle* selectedCells 
);

Sélectionnez

void SetSelectedCells( 
int blockIndex, 
IFRRectangle selectedCells 
);

Sélectionnez

Sub SetSelectedCells( _ 
blockIndex As Integer, _ 
selectedCells As IFRRectangle _ 
)

VI-F. Paramètres▲

blockIndex

[in] Spécifie l'index d'un bloc de table. L'index se trouve dans la collection ILayout::VisualBlocks.

selectedCells

[in] Se réfère à l'objet FRRectangle qui spécifie les coordonnées du rectangle environnant des cellules à sélectionner. Les coordonnées sont définies dans une grille de base.

Valeurs de retour

Cette méthode n'a pas de valeurs de retour spécifiques. Elle renvoie les valeurs de retour standard d'ABBYY FineReader Engine functions.

Remarques

VII. Méthode ShowDocumentArea de l'objet ZoomViewer▲

Cette méthode vous permet de faire défiler la vue en zoom afin que la zone du document aux coordonnées spécifiées devienne visible (dans la mesure du possible).

Sélectionnez

Sub ShowDocumentArea(Value As IFRRectangle)

Sélectionnez

void ShowDocumentArea( IFRRectangle Value );

C++

Sélectionnez

HRESULT ShowDocumentArea( IFRRectangle* Value );

VII-A. Paramètres▲

Valeur

[in] Fait référence à l'objet FRRectangle qui spécifie les coordonnées de la zone du document en pixels. Les coordonnées sont relatives à l'image du document.

VII-B. Valeurs de retour▲

Cette méthode n'a pas de valeurs de retour spécifiques. Elle renvoie les valeurs de retour standard d'ABBYY FineReader Engine functions.

VIII. Méthode UpdateOptions de l'objet ZoomViewer▲

Cette méthode met à jour les paramètres spécifiés dans la boîte de dialogue Options de Zoom Viewer. Vous pouvez avoir besoin d’appeler cette méthode, si les options ont été modifiées dans un autre composant visuel, pour mettre à jour des options de Zoom Viewer à l'état actuel.

Remarque : la boîte de dialogue Options peut être affichée si la commande MI_Options est appelée dans Image Viewer, Zoom Viewer, Text Editor, ou Document Viewer, si le bouton Options est cliqué dans la boîte de dialogue Save as de Document Viewer, ou si vous cliquez sur Paramètres > Options dans Text Validator.

VIII-A. Syntaxe▲

C++

Sélectionnez

HRESULT UpdateOptions();

Sélectionnez

void UpdateOptions();

Visual Basique . Net

Sélectionnez

Sub UpdateOption() ;

VIII-B. Valeurs de retour▲

Cette méthode n'a pas de valeurs de retour spécifiques. Elle renvoie les valeurs de retour standard d'ABBYY FineReader Engine functions.

IX. DocumentViewer Object (interface IDocumentViewer)▲

L'objet DocumentViewer est un contrôle ActiveX qui vous permet de visualiser la liste des pages dans le document et surveiller leur état. Vous pouvez également enregistrer le document reconnu ou l'ouvrir dans le dossier en utilisant les commandes disponibles dans le composant. Un document est connecté au composant via la propriété du FRDocument.

Le composant Document Viewer peut se présenter comme suit, en fonction de la valeur de la propriété Mode :

- Vue détaillée

Fournit des informations détaillées sur chaque page de document.

- Vue miniature

Affiche les pages du document sous forme de vignettes.

Vous pouvez modifier l'apparence du composant via ses propriétés. Par exemple, vous pouvez ajouter des boutons à sa barre d'outils et de les en retirer via la propriété Toolbar, ou de modifier le menu contextuel via la propriété PopupMenu. Voir Personnalisation du menu contextuel et de la barre d'outils d'un visuel composante pour les détails.

Les informations relatives au suivi du document sont communiquées par des interfaces sortantes spéciales. Ces interfaces sont IDocumentViewerEvents (pour C++) et une DIDocumentViewerEvents dispinterface (pour Visual Basic).

Il est bon de noter que les utilisateurs de Visual Basic ne doivent pas se soucier des détails de la mise en œuvre des interfaces d'événements, car cette plateforme de développement offre des moyens faciles de les manipuler. Cet objet peut être déclaré WithEvents sous Visual Basic.

Pour l'utilisateur C++, cela signifie qu'il prend en charge l'interface IConnectionPointContainer. Pour recevoir les notifications d’événements, un utilisateur C++ doit créer un objet dérivé de l'IDocumentViewerEvents puis établir la connexion entre celle-ci et la source d'événements mise en œuvre dans DocumentViewer objet par des moyens COM standard.

Le composant « Document Viewer » peut être connecté au composant « Component Synchronizer ». Dans ce cas, tous les événements dans le Document Viewer seront automatiquement transmis aux autres composants connectés au Synchroniseur et l'ensemble de l'application fonctionnera de manière synchrone.

Propriétés

Nom	Type	Description
FRDocument	FRDocument	Précise le document connecté à Document Viewer.
LanguagePaneEnabled	VARIANT_BOOL	Précise si la langue de Document Viewer est activée. Si cette propriété est FALSE, la page de langue n'est pas affichée. Par défaut, la valeur est TRUE.
Locked	VARIANT_BOOL	Précise si le Document Viewer est verrouillé. Cette propriété est utile dans les situations suivantes : - analyse, reconnaissance, synthèse, ou exportation d'opérations est appelée de l'API FineReader Engine (pas de Visual Components), ou - votre demande reçoit les notifications de certains événements (par ex. du FRDocument objet) et les processus messages Windows depuis des éléments visuels de ces gestionnaires d'événements. Dans ce cas, nous recommandons que vous ayez mis cette propriété sur TRUE avant l'analyse, la reconnaissance, synthèse ou l'exportation, et le mettre à FALSE après la fin de l'opération. Dans ce cas, le document ne peut être altéré par Document Viewer. Par défaut, la valeur est FALSE.
Mode	DocumentViewerModeEnum	Précise le mode actuel de Document Viewer : Détails ou Vue miniature. Par défaut, le mode est DVM_Thumbnails.
PopupMenu	PopupMenu, read-only	Permet d'accéder aux paramètres du menu contextuel.
ProcessingParams	DocumentProcessingParams	Spécifie les paramètres de traitement par défaut du document. Ces paramètres sont utilisés si les processus d'analyse et de reconnaissance sont appelés directement à partir de Document Viewer. Note : Si Document Viewer est connecté à Component Synchronizer, utilisez la propriété IComponentSynchronizer::ProcessingParams pour modifier les paramètres utilisés pour le traitement. Si vous modifiez les paramètres de traitement via la propriété de Document Viewer, des erreurs peuvent se produire.
Titre	BSTR	Spécifie le titre du composant Document Viewer. Par défaut, il s'agit de « Pages ».
Barre d’outils	Toolbar, read-only	Permet d'accéder aux paramètres de la barre d'outils.
SelectedPagesIndices	IntsCollection	Donne accès à la collection d'index des pages sélectionnées.
` SettingsPath	BSTR	Spécifie le chemin d'accès au dossier qui contient les fichiers avec les paramètres de Document Viewer. Les autres composants visuels ont la même propriété. Chaque composant visuel doit utiliser son propre dossier avec les paramètres. La valeur de cette propriété est construite à partir du chemin d'accès au dossier, dans lequel ABBYY FineReader Engine stocke les données spécifiques à l'utilisateur, et du nom de son sous-dossier. Par défaut, le dossier contenant les données spécifiques à l'utilisateur est le dossier de données de FineReader Engine. Il peut être modifié lors de l'initialisation de FineReader Engine (via la fonction InitializeEngine, ou via la méthode IEngineLoader::InitializeEngine). Le nom par défaut du sous-dossier est un GUID arbitraire. Pour changer le nom du sous-dossier, vous devez spécifier le nouveau nom dans les propriétés du composant dans Visual Studio au moment de la conception. Si vous essayez de spécifier la valeur de la propriété au moment de l'exécution, cette valeur est ignorée. Si vous ajoutez le composant à un formulaire dans Visual Studio au moment de la conception, la valeur de la propriété est définie soit automatiquement avec la valeur par défaut, soit manuellement avec une valeur personnalisée. Dans les deux cas, la valeur est définie au moment de la conception. Si, pour une raison quelconque, la valeur de la propriété n'est pas définie au moment de la conception (par exemple si vous générez le composant dynamiquement au moment de l'exécution), le composant crée un nouveau dossier avec les paramètres à chaque fois que le composant est initialisé. Pour éviter la multiplication des dossiers, vous devez supprimer le dossier des paramètres créés après la désinitialisation du composant. Dans ce cas, vous pouvez utiliser uniquement les paramètres par défaut du composant et ne pouvez pas enregistrer les paramètres entre les sessions.
WindowHandle	__int64, read-only	Renvoie la poignée de fenêtre de l'espace client.

Méthodes

Nom	Description
UpdateOptions	Met à jour les paramètres spécifiés dans la boîte de dialogue Options de Document Viewer. Vous pouvez avoir besoin d'appeler cette méthode, si les options ont été modifiées dans un autre composant visuel, pour mettre à jour les options de Document Viewer à l'état actuel.

Échantillons

Ce composant est utilisé dans les exemples de code suivants : VisualComponents.

Commandes de la visionneuse de documents

Vous trouverez ci-dessous la liste des commandes disponibles dans la visionneuse de documents. Les commandes peuvent être appelées :

en sélectionnant un élément dans un menu contextuel ;
en cliquant sur un bouton de la barre d'outils ;
en appuyant sur une touche de raccourci ;
en utilisant la méthode DoCommand de l'objet secondaire d'une composante.

Cependant, toutes ces méthodes ne sont pas disponibles pour chaque commande. La disponibilité de telle ou telle méthode d'appel est décrite dans le tableau ci-dessous : « + » signifie que la commande est disponible par défaut, « * » - la commande peut être ajoutée par le développeur.

Éléments

MenuItemEn um constant	Description	Context menu	Barre d’outils	DoCommand	Hot key
MI_AnalyzeLay out	Analyse automatiquement la mise en page des pages d'images sélectionnées.	+		+	Ctrl+E
MI_DeletePag e	Supprime la page sélectionnée du document en cours.	+	*	+	Del
MI_Document ViewDetails	Sélectionne la vue du document en détail	+		+
MI_Document ViewThumbna ils	Sélectionne la vue du document sous forme de vignettes.	+		+
MI_FlipHorizo ntal	Retourne l'image horizontalement.	+		+
MI_FlipVertical	Retourne l'image verticalement.	+		+
MI_GotoPage	Va à la page spécifiée.	*	*	+	Ctrl + G
MI_Language Editor	Ouvre la boîte de dialogue de l'éditeur de langue, qui vous permet de sélectionner et de modifier les langues de reconnaissance.	*	*	+	Ctrl+Shift+L
MI_NextPage	Voir page suivante.	*	+	+	Ctrl + Num + or Alt+Down Arrow
MI_Options	Affiche la boîte de dialogue Options, qui vous permet de spécifier différentes options d'affichage et d'enregistrement.	*	*	+
MI_PrevPage	Affiche la page précédente.	*	+	+	Ctrl+Num- or Alt+Up Arrow
MI_Properties	Affiche les propriétés de la page sélectionnée.	+		+	Alt+Enter
MI_Read	Reconnaît les pages sélectionnées.	+		+	Ctrl+R
MI_Renumber Pages	Ouvre la boîte de dialogue Renuméroter les pages, qui vous permet de renuméroter les pages.	+	*	+
MI_RotateCloc kwise	Tourne l'image de 90° dans le sens des aiguilles d'une montre.	+		+
MI_RotateCou nterClockwise	Tourne l'image de 90° dans le sens inverse des aiguilles d'une montre.	+		+
MI_RotateUps ideDown	Tourne l'image à l'envers (180°).	+		+
MI_SaveAsCsv	Enregistre le texte reconnu au format CSV.	+		+
MI_SaveAsDo cX	Enregistre le texte reconnu au format DOCX.	+		+
MI_SaveAsEpu b	Enregistre le texte reconnu au format EPUB.	+		+
MI_SaveAsFb2	Enregistre le texte reconnu au format FB2.	+		+
MI_SaveAsHt m	Enregistre le texte reconnu au format HTML.	+		+
MI_SaveAsOdt	Enregistre le texte reconnu au format ODT.	+		+
MI_SaveAsPdf	Enregistre le texte reconnu au format PDF.	+		+
MI_SaveAsPdf A	Enregistre le texte reconnu au format PDF/A.	+		+
MI_SaveAsPpt X	Enregistre le texte reconnu au format PPTX.	+		+
MI_SaveAsRtf	Enregistre le texte reconnu au format RTF.	+		+
MI_SaveAsTxt	Enregistre le texte reconnu au format TXT.	+		+
MI_SaveAsXls	Enregistre le texte reconnu au format XLS.	+		+
MI_SaveAsXls X	Enregistre le texte reconnu au format XLSX.	+		+
MI_SendToAcr obat	Ouvre un texte reconnu dans Adobe Acrobat ou Adobe Reader.	+		+
MI_SendToCli pboard	Coller un texte reconnu dans le Presse-papiers.	+		+
MI_SendToMS Excel	Ouvre un texte reconnu dans Microsoft Excel.	+		+
MI_SendToMS Word	Ouvre un texte reconnu dans Microsoft Word.	+		+
MI_SendToOp enOffice	Ouvre un texte reconnu dans OpenOffice.org.	+		+
MI_SendToPo werPoint	Ouvre un texte reconnu dans Microsoft PowerPoint.	+		+
MI_SendToWe bBrowser	Ouvre un texte reconnu dans le navigateur Internet.	+		+
MI_SendToW ordPerfect	Ouvre un texte reconnu dans Corel WordPerfect.	+		+
MI_SendToW ordPro	Ouvre un texte reconnu dans Lotus Word Pro.	+		+
MI_Separator	Ajoute un séparateur à la barre d'outils ou au menu contextuel.	+	*
MI_SubMenu	Ajoute un sous-menu au menu contextuel.	+
MI_ViewDictio naries	Ouvre la boîte de dialogue Sélectionner un dictionnaire, qui vous permet de visualiser et de modifier les propriétés du dictionnaire.	*	*	+	Ctrl+Alt+D
MI_CustomCo mmand1	Permet de définir une commande personnalisée.	*	*	+
MI_CustomCo Mmand2	Permet de définir une commande personnalisée.	*	*	+
MI_CustomCo mmand3	Permet de définir une commande personnalisée.	*	*	+
MI_CustomCo mmand4	Permet de définir une commande personnalisée.	*	*	+
MI_CustomCo mmand5	Permet de définir une commande personnalisée.	*	*	+
MI_CustomCo mmand6	Permet de définir une commande personnalisée.	*	*	+
MI_CustomCo Mmand7	Permet de définir une commande personnalisée.	*	*	+
MI_CustomCo Mmand8	Permet de définir une commande personnalisée.	*	*	+
MI_CustomCo Mmand9	Permet de définir une commande personnalisée.	*	*	+
MI_CustomCo Mmand10	Permet de définir une commande personnalisée.	*	*	+

Vous avez aimé ce tutoriel ? Alors partagez-le en cliquant sur les boutons suivants :

Les sources présentées sur cette page sont libres de droits et vous pouvez les utiliser à votre convenance. Par contre, la page de présentation constitue une œuvre intellectuelle protégée par les droits d'auteur. Copyright © 2020 ABBY. Aucune reproduction, même partielle, ne peut être faite de ce site ni de l'ensemble de son contenu : textes, documents, images, etc. sans l'autorisation expresse de l'auteur. Sinon vous encourez selon la loi jusqu'à trois ans de prison et jusqu'à 300 000 € de dommages et intérêts.