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 Donner une note  l'article (5)

Article lu   fois.

L'auteur

Liens sociaux

Viadeo Twitter Facebook Share on Google+   

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 
);
C#
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 );
C#
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 
);
C#
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 
);
C#
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 );
C#
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 
);
C#
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

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.

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();
C#
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 : Viadeo Twitter Facebook Share on Google+   

  

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.