Passer au contenu principal
Les composants visuels sont implémentés dans FRE pour Windows.
L’objet DocumentViewer est un contrôle ActiveX qui permet d’afficher la liste des pages du document et d’en surveiller l’état. Vous pouvez également enregistrer le document reconnu ou l’ouvrir dans l’application sélectionnée à l’aide des commandes disponibles dans le composant. Un document est associé au composant via la propriété FRDocument. Selon la valeur de la propriété Mode, le composant Document Viewer peut se présenter comme suit :
  • Vue détaillée
Fournit des informations détaillées sur chaque page du document. DocumentViewer_Details
  • Vue en miniatures
Affiche les pages du document sous forme de miniatures. DocumentViewer_Thumbnails Vous pouvez modifier l’apparence du composant via ses propriétés. Par exemple, vous pouvez ajouter des boutons à sa barre d’outils ou en supprimer via la propriété Toolbar, ou modifier le menu contextuel du composant via la propriété PopupMenu. Pour plus de détails, voir Personnalisation du menu contextuel et de la barre d’outils d’un composant visuel. Les informations relatives au suivi du document sont transmises via des interfaces sortantes spéciales. Ces interfaces sont IDocumentViewerEvents (pour C++) et une dispinterface, DIDocumentViewerEvents (pour Visual Basic). Il convient de noter que les utilisateurs de Visual Basic n’ont pas à se préoccuper des détails d’implémentation des interfaces d’événements, car cette plateforme de développement fournit des moyens simples de les gérer. Cet objet peut être déclaré avec WithEvents dans Visual Basic. Pour un 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’interface IDocumentViewerEvents, puis établir une connexion entre celui-ci et la source d’événements implémentée dans l’objet DocumentViewer à l’aide des mécanismes COM standard. Le composant Document Viewer peut être connecté au composant Component Synchronizer. Dans ce cas, tous les événements de Document Viewer sont automatiquement transmis aux autres composants connectés à Synchronizer, et l’ensemble de l’application fonctionne de manière synchrone.

Propriétés

Indique la page active dans Document Viewer. S’il n’y a pas de page active, la valeur de cette propriété est 0.

Indique si le volet de légende de Document Viewer est activé. Si cette propriété est FALSE, le volet de légende n’est pas affiché.

Par défaut, la valeur est TRUE.

Indique si le menu contextuel de Document Viewer est activé. Si cette propriété est FALSE, le menu contextuel n’est jamais affiché.

Par défaut, la valeur est TRUE.

,lecture seule

Donne accès aux commandes disponibles dans Document Viewer. Voirla liste des commandes disponibles dans Document Viewer.

Indique le document associé à Document Viewer.

Indique si le volet de langue de Document Viewer est activé. Si cette propriété est FALSE, le volet de langue n’est pas affiché.

Par défaut, la valeur est TRUE.

Indique si Document Viewer est verrouillé.

Cette propriété est utile dans les cas suivants :

  • une opération d’analyse, de reconnaissance, de synthèse ou d’exportation est appelée depuis l’API FineReader Engine (et non depuis Visual Components), ou
  • votre application reçoit des notifications de certains événements (par exemple, de l’objet) et traite les messages Windows provenant de Visual Components dans ces gestionnaires d’événements.

Dans ce cas, il est recommandé de définir cette propriété sur TRUE avant l’analyse, la reconnaissance, la synthèse ou l’exportation, puis sur FALSE à la fin de l’opération. Le document ne peut ainsi pas être altéré depuis Document Viewer.

Par défaut, la valeur est FALSE.

Indique le mode actuel de Document Viewer : vue Détails ou Miniatures.

Par défaut, le mode est DVM_Thumbnails.

,lecture seule

Donne accès aux paramètres du menu contextuel.

Indique les paramètres de traitement par défaut du document. Ces parameters are used if the analysis and recognition processes are called directly from Document Viewer.

If Document Viewer is connected to Component Synchronizer, use theIComponentSynchronizer::ProcessingParamsproperty to change parameters used for processing. If you change processing parameters via the property of Document Viewer, errors may occur.

Specifies the title of the Document Viewer component.

By default, it is “Pages”.

,read-only

Provides access to the toolbar settings.

Provides access to the collection of indices of selected pages.

Specifies the path to the folder which contains files with the settings of Document Viewer. Other Visual Components have the same property. Each Visual Component should use its own folder with settings.

The value of this property is constructed from the path to the folder, in which ABBYY FineReader Engine stores user-specific data, and the name of its subfolder. By default, the folder with user-specific data is theFineReader Engine data folder. It can be changed during initialization of FineReader Engine (via thefunction, or via themethod). The default name of the subfolder is an arbitrary GUID. To change the name of the subfolder, you should specify the new name in the properties of the component in Visual Studio at design time. If you try to specify the value of the property at run time, this value is ignored.

Si vous ajoutez le composant à un formulaire dans Visual Studio lors 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 de paramètres à chaque initialisation. Pour éviter la prolifération des dossiers, vous devez supprimer le dossier de paramètres créé après la désinitialisation du composant. Dans ce cas, vous ne pouvez utiliser que les paramètres par défaut du composant et ne pouvez pas enregistrer les paramètres d’une session à l’autre.

, read-only

Returns the window handle of the client area.

Méthodes

NomDescription
UpdateOptionsMet à jour les paramètres spécifiés dans la boîte de dialogue Options de Document Viewer. Vous devrez peut-être appeler cette méthode si les options ont été modifiées dans un autre composant visuel, afin de synchroniser les options de Document Viewer avec leur état actuel.

Exemples

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

Voir aussi

IDocumentViewerEvents IComponentSynchronizer::DocumentViewer Créer une application avec une interface utilisateur graphique Personnalisation du menu contextuel et de la barre d’outils d’un composant visuel