> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Objet ImageViewer (interface IImageViewer)

> Objet ImageViewer (interface IImageViewer) dans ABBYY FineReader Engine Visual Components sous Windows — l’objet ImageViewer est un contrôle ActiveX qui permet d’afficher et de modifier une image ainsi que les blocs qu’elle contient.

<Warning>
  Visual Components est implémenté dans FRE pour Windows.
</Warning>

L’objet ImageViewer est un contrôle ActiveX qui permet d’afficher et de modifier une image ainsi que les blocs qu’elle contient. Une image est associée à Image Viewer via la propriété FRPage.

Le composant Image Viewer se présente comme suit :

<img src="https://mintcdn.com/abbyy/lsETHFYUFiongXSm/images/fine-reader/engine/imageviewer.gif?s=0d5ce6ef4bfe778c2c0b224a73b839e0" alt="ImageViewer" width="529" height="279" data-path="images/fine-reader/engine/imageviewer.gif" />

Vous pouvez modifier l’apparence du composant via ses propriétés. Par exemple, vous pouvez ajouter des boutons à sa barre d’outils et en supprimer via la propriété Toolbar, ou modifier le menu contextuel du composant via la propriété PopupMenu. Pour plus de détails, consultez [Personnalisation du menu contextuel et de la barre d’outils d’un composant visuel](/fr/fine-reader/engine/guided-tour/advanced-techniques/using-gui-elements/customizing-the-context-menu-and-toolbar-of-a-visual-component).

Les informations relatives à l’affichage et à la modification de l’image sont transmises par des interfaces sortantes spéciales. Ces interfaces sont [IImageViewerEvents](/fr/fine-reader/engine/visual-components-reference/iimageviewerevents) (pour C++) et une dispinterface [DIImageViewerEvents](/fr/fine-reader/engine/visual-components-reference/iimageviewerevents) (pour Visual Basic).

Il convient de noter que les utilisateurs de Visual Basic n’ont pas à se soucier des détails d’implémentation des interfaces d’événements, car cet environnement 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 des notifications d’événements, un utilisateur C++ doit créer un objet dérivé de l’interface IImageViewerEvents, puis établir la connexion entre celui-ci et la source d’événements implémentée dans l’objet ImageViewer à l’aide des mécanismes COM standard.

Le composant Image Viewer peut être connecté au composant [Component Synchronizer](/fr/fine-reader/engine/visual-components-reference/supplementary-objects/componentsynchronizer), auquel cas tous les événements d’Image Viewer seront automatiquement transmis aux autres composants connectés au Synchronizer et l’ensemble de l’application fonctionnera de manière synchrone.

<div id="properties">
  ## Propriétés
</div>

<table>
  <thead>
    <tr>
      <th>
        <p>
          <strong>Nom</strong>
        </p>
      </th>

      <th>
        <p>
          <strong>Type</strong>
        </p>
      </th>

      <th>
        <p>
          <strong>Description</strong>
        </p>
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        <p>
          <a name="activetool" />

          <strong>ActiveTool</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/fr/fine-reader/engine/visual-components-reference/enumerations/boxeditortoolenum">
              BoxEditorToolEnum
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>Spécifie l'outil actif pour l'édition des blocs et des images.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <a name="allpagesscrollenabled" />

          <strong>AllPagesScrollEnabled</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/fr/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">
              Boolean
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          Spécifie si Image Viewer doit faire défiler toutes les pages du
          document. Si cette propriété est FALSE, Image Viewer ne fait défiler
          que la page sélectionnée.
        </p>

        <p>Par défaut, la valeur est TRUE.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <a name="bottompaneenabled" />

          <strong>BottomPaneEnabled</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/fr/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">
              VARIANT\_BOOL
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          Spécifie si le volet inférieur d'Image Viewer est activé. Si cette
          propriété est FALSE, le volet inférieur n'est pas affiché.
        </p>

        <p>Par défaut, la valeur est TRUE.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <a name="captionpaneenabled" />

          <strong>CaptionPaneEnabled</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/fr/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">
              VARIANT\_BOOL
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          Spécifie si le volet de légende d'Image Viewer est activé. Si cette
          propriété est FALSE, le volet de légende n'est pas affiché.
        </p>

        <p>Par défaut, la valeur est TRUE.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <a name="contextmenuenabled" />

          <strong>ContextMenuEnabled</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/fr/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">
              VARIANT\_BOOL
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          Spécifie si le menu contextuel d'Image Viewer est activé. Si cette
          propriété est FALSE, le menu contextuel ne s'affiche jamais.
        </p>

        <p>Par défaut, la valeur est TRUE.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <a name="commands" />

          <strong>Commands</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/fr/fine-reader/engine/visual-components-reference/supplementary-objects/commands">
              Commands
            </a>
          </strong>

          ,{" "}

          <a href="/fr/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties#readonly_properties">
            read-only
          </a>
        </p>
      </td>

      <td>
        <p>
          Donne accès aux commandes disponibles dans Image Viewer. Voir{" "}

          <a href="/fr/fine-reader/engine/visual-components-reference/imageviewer/image-viewer-commands">
            la liste des commandes disponibles dans Image Viewer
          </a>

          .
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <a name="frpage" />

          <strong>FRPage</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/fr/fine-reader/engine/api-reference/document-related-objects/frpage">
              FRPage
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>Spécifie la page du document connectée à Image Viewer.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <a name="highlightrecognizedarea" />

          <strong>HighlightRecognizedArea</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/fr/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">
              VARIANT\_BOOL
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          Spécifie si les fragments reconnus doivent être mis en surbrillance sur
          l'image pendant la reconnaissance. Cette propriété permet de suivre
          la progression de la reconnaissance.
        </p>

        <p>Par défaut, la valeur est TRUE.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <a name="locked" />

          <strong>Locked</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/fr/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">
              VARIANT\_BOOL
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>Spécifie si Image Viewer est verrouillé.</p>
        <p>Cette propriété est utile dans les situations suivantes :</p>

        <ul>
          <li>
            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
          </li>

          <li>
            votre application reçoit des notifications de certains événements (par ex.,
            de l'objet

            <strong>
              {" "}

              <a href="/fr/fine-reader/engine/api-reference/document-related-objects/frdocument">
                FRDocument
              </a>

              {" "}
            </strong>

            ) et traite les messages Windows provenant de Visual Components dans
            ces gestionnaires d'événements.
          </li>
        </ul>

        <p>
          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 de la redéfinir sur FALSE à
          la fin de l'opération. Le document ne peut ainsi pas être altéré
          depuis Image Viewer.
        </p>

        <p>Par défaut, la valeur est FALSE.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <a name="popupmenu" />

          <strong>PopupMenu</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/fr/fine-reader/engine/visual-components-reference/supplementary-objects/popupmenu">
              PopupMenu
            </a>
          </strong>

          ,{" "}

          <a href="/fr/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties#readonly_properties">
            lecture seule
          </a>
        </p>
      </td>

      <td>
        <p>Donne accès aux paramètres du menu contextuel.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <a name="processingparams" />

          <strong>ProcessingParams</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/fr/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/documentprocessingparams">
              DocumentProcessingParams
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          Spécifie les paramètres de traitement par défaut d'un document. Ces
          paramètres sont utilisés lorsque les processus d'analyse, de reconnaissance
          et de synthèse sont appelés directement depuis Image Viewer.
        </p>

        <Note>
          Si Image Viewer est connecté à Component Synchronizer, utilisez la propriété{" "}

          <a href="/fr/fine-reader/engine/visual-components-reference/supplementary-objects/componentsynchronizer#processingparams">
            IComponentSynchronizer::ProcessingParams
          </a>

          {" "}

          pour modifier les paramètres de traitement. Si vous modifiez
          les paramètres de traitement via la propriété d'Image Viewer, des erreurs
          peuvent survenir.
        </Note>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <a name="selectedpagesindices" />

          <strong>SelectedPagesIndices</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/intscollection">
              IntsCollection
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          Donne accès à la collection d'indices des pages sélectionnées dans
          la boîte de dialogue <strong>Image Editor</strong>.
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <a name="settingspath" />

          <strong>SettingsPath</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/fr/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">
              BSTR
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          Spécifie le chemin d'accès au dossier contenant les fichiers de
          paramètres d'Image Viewer. Les autres Visual Components possèdent la même
          propriété. Chaque Visual Component doit utiliser son propre dossier de
          paramètres.
        </p>

        <p>
          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
          propres à l'utilisateur, et du nom de son sous-dossier. Par défaut,
          le dossier contenant les données propres à l'utilisateur est le{" "}

          <a href="/fr/fine-reader/engine/distribution/distribution-windows/distribution-kit#finereader_engine_data_folder">
            dossier de données FineReader Engine
          </a>

          . Il peut être modifié lors de l'initialisation de FineReader Engine.
          Le nom par défaut du sous-dossier est un GUID arbitraire. Pour modifier
          le nom du sous-dossier, spécifiez le nouveau nom dans les
          propriétés du composant dans Visual Studio au moment de la conception.
          Si vous tentez de spécifier la valeur de la propriété au moment de
          l'exécution, cette valeur est ignorée.
        </p>

        <p>
          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, supprimez
          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 entre les sessions.
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <a name="title" />

          <strong>Title</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/fr/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">
              BSTR
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>Spécifie le titre du composant Image Viewer.</p>
        <p>Par défaut, la valeur est "Image".</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <a name="toolbar" />

          <strong>Toolbar</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/fr/fine-reader/engine/visual-components-reference/supplementary-objects/toolbar">
              Toolbar
            </a>
          </strong>

          ,{" "}

          <a href="/fr/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties#readonly_properties">
            lecture seule
          </a>
        </p>
      </td>

      <td>
        <p>Donne accès aux paramètres de la barre d'outils.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <a name="viewscale" />

          <strong>ViewScale</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/fr/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">
              int
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          Spécifie l'échelle de l'image en pourcentage. Cette propriété
          peut également être définie sur l'une des constantes{" "}

          <strong>
            <a href="/fr/fine-reader/engine/visual-components-reference/enumerations/scaletypes">
              ScaleTypes
            </a>
          </strong>

          {" "}

          constants.
        </p>

        <p>
          Par défaut, la valeur est ST\_BestFit, ce qui signifie que l'ajustement
          optimal est sélectionné automatiquement.
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <a name="visibledocumentarea" />

          <strong>VisibleDocumentArea</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/frrectangle">
              FRRectangle
            </a>
          </strong>

          ,{" "}

          <a href="/fr/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties#readonly_properties">
            lecture seule
          </a>
        </p>
      </td>

      <td>
        <p>
          Stocke les coordonnées de la zone de document visible en pixels. Les
          coordonnées sont relatives à l'image du document.
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <a name="windowhandle" />

          <strong>WindowHandle</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/fr/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">
              \_\_int64
            </a>
          </strong>

          , lecture seule
        </p>
      </td>

      <td>
        <p>Retourne le handle de fenêtre de la zone client.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <a name="zoomrect" />

          <strong>ZoomRect</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/frrectangle">
              FRRectangle
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          Stocke les coordonnées du rectangle de la zone de zoom en pixels. Les
          coordonnées sont relatives à l'image du document.
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <a name="zoomrectenabled" />

          <strong>ZoomRectEnabled</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/fr/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">
              VARIANT\_BOOL
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          Indique si la zone de zoom doit être marquée sur l'image par un
          rectangle en pointillés.
        </p>

        <p>Par défaut, la valeur est TRUE.</p>
      </td>
    </tr>
  </tbody>
</table>

<div id="methods">
  ## Méthodes
</div>

| Name                                                                                                                       | Description                                                                                                                                                                                                                                                                      |
| -------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [CenterOnDocumentPoint](/fr/fine-reader/engine/visual-components-reference/imageviewer/centerondocumentpoint-method)       | Fait défiler la vue de l’image afin de placer le point spécifié au centre de la vue.                                                                                                                                                                                             |
| [DocumentToScreen](/fr/fine-reader/engine/visual-components-reference/imageviewer/documenttoscreen-method)                 | Convertit les coordonnées du point spécifié sur l’image du document en coordonnées écran.                                                                                                                                                                                        |
| [GetSelectedBlocksIndices](/fr/fine-reader/engine/visual-components-reference/imageviewer/getselectedblocksindices-method) | Renvoie la collection d’indices des blocs sélectionnés.                                                                                                                                                                                                                          |
| [GetSelectedCells](/fr/fine-reader/engine/visual-components-reference/imageviewer/getselectedcells-method)                 | Renvoie le rectangle englobant des cellules sélectionnées dans le bloc de tableau spécifié.                                                                                                                                                                                      |
| [Print](/fr/fine-reader/engine/visual-components-reference/imageviewer/print-method)                                       | Imprime l’image.                                                                                                                                                                                                                                                                 |
| [ScreenToDocument](/fr/fine-reader/engine/visual-components-reference/imageviewer/screentodocument-method)                 | Convertit les coordonnées écran du point spécifié en coordonnées sur l’image du document.                                                                                                                                                                                        |
| [SetSelectedBlocksIndices](/fr/fine-reader/engine/visual-components-reference/imageviewer/setselectedblocksindices-method) | Définit la sélection de blocs.                                                                                                                                                                                                                                                   |
| [SetSelectedCells](/fr/fine-reader/engine/visual-components-reference/imageviewer/setselectedcells-method)                 | Définit les cellules sélectionnées du bloc de tableau spécifié.                                                                                                                                                                                                                  |
| [ShowDocumentArea](/fr/fine-reader/engine/visual-components-reference/imageviewer/showdocumentarea-method)                 | Fait défiler la vue de l’image afin de rendre visible, dans la mesure du possible, la zone du document ayant les coordonnées spécifiées.                                                                                                                                         |
| [UpdateOptions](/fr/fine-reader/engine/visual-components-reference/imageviewer/updateoptions-method)                       | Met à jour les paramètres spécifiés dans la boîte de dialogue Options d’Image Viewer. Il peut être nécessaire d’appeler cette méthode si les options ont été modifiées dans un autre composant visuel, afin de mettre à jour celles d’Image Viewer en fonction de l’état actuel. |

<div id="samples">
  ## Exemples
</div>

Ce composant est utilisé dans les exemples de code suivants : [VisualComponents](/fr/fine-reader/engine/guided-tour/samples#visualcomponents).

<div id="see-also">
  ## Voir aussi
</div>

[IImageViewerEvents](/fr/fine-reader/engine/visual-components-reference/iimageviewerevents)

[IComponentSynchronizer::ImageViewer](/fr/fine-reader/engine/visual-components-reference/supplementary-objects/componentsynchronizer#imageviewer)

[Créer une application avec une interface utilisateur graphique](/fr/fine-reader/engine/guided-tour/advanced-techniques/using-gui-elements/creating-an-application-with-gui)

[Personnalisation du menu contextuel et de la barre d’outils d’un composant visuel](/fr/fine-reader/engine/guided-tour/advanced-techniques/using-gui-elements/customizing-the-context-menu-and-toolbar-of-a-visual-component)

[Utilisation des propriétés](/fr/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties)