> ## 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 ZoomViewer (interface IZoomViewer)

> Objet ZoomViewer (interface IZoomViewer) dans les composants visuels d’ABBYY FineReader Engine sous Windows — L’objet ZoomViewer est un contrôle ActiveX qui vous permet d’afficher une image agrandie de la ligne ou de la zone de l’image traitée...

<Warning>
  Les composants visuels sont implémentés dans FRE sous Windows.
</Warning>

L’objet ZoomViewer est un contrôle ActiveX qui vous permet d’afficher une image agrandie de la ligne ou de la zone de l’image traitée en cours de modification. Alors que [Image Viewer](/fr/fine-reader/engine/visual-components-reference/imageviewer) affiche une vue générale de la page, Zoom Viewer permet d’afficher l’image plus en détail, d’ajuster la position de la zone ou de comparer des caractères incertains avec l’image agrandie. Une image est reliée à Zoom Viewer via la propriété FRPage.

Le composant Zoom Viewer se présente comme suit :

<img src="https://mintcdn.com/abbyy/B_SRGbkkbQ9YH40E/images/fine-reader/engine/zoomviewer.gif?s=c3d3ed6f17c9738f26795a72a9c35c42" alt="ZoomViewer" width="494" height="212" data-path="images/fine-reader/engine/zoomviewer.gif" />

Vous pouvez modifier l’apparence du composant via ses propriétés. Par exemple, vous pouvez modifier le menu contextuel du composant via la propriété Commands. Voir [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) pour plus d’informations.

Les informations relatives à l’affichage de l’image sont transmises via des interfaces de sortie spéciales. Ces interfaces sont [IZoomViewerEvents](/fr/fine-reader/engine/visual-components-reference/izoomviewerevents) (pour C++) et une dispinterface [DIZoomViewerEvents](/fr/fine-reader/engine/visual-components-reference/izoomviewerevents) (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 cette plateforme de développement fournit des moyens simples de les gérer. Cet objet peut être déclaré avec le mot-clé WithEvents dans Visual Basic.

Pour les utilisateurs de 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 IZoomViewerEvents, puis établir la connexion entre celui-ci et la source d’événements implémentée dans l’objet ZoomViewer à l’aide des mécanismes COM standard.

Le composant Zoom Viewer peut être connecté au composant [Component Synchronizer](/fr/fine-reader/engine/visual-components-reference/supplementary-objects/componentsynchronizer), auquel cas tous les événements de Zoom 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="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 du Zoom 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="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 du Zoom Viewer est activé. Si cette
          propriété est FALSE, le menu contextuel n'est jamais affiché.
        </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 Zoom Viewer. Voir{" "}

          <a href="/fr/fine-reader/engine/visual-components-reference/zoomviewer/zoom-viewer-commands">
            la liste des commandes disponibles dans Zoom 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>Représente la page du document connectée au Zoom Viewer.</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 le Zoom 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 les composants visuels), ou
          </li>

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

            <strong>
              {" "}

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

              {" "}
            </strong>

            ) et traite les messages Windows provenant des composants visuels dans
            ces gestionnaires d'événements.
          </li>
        </ul>

        <p>
          Dans ce cas, nous vous recommandons 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 le Zoom Viewer.
        </p>

        <p>Par défaut, la valeur est FALSE.</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 pour le document. Ces
          paramètres sont utilisés si les processus d'analyse et de reconnaissance sont
          appelés directement depuis le Zoom Viewer.
        </p>

        <Note>
          Si le Zoom Viewer est connecté au 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é du Zoom Viewer, des erreurs risquent de
          survenir.
        </Note>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <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 vers le dossier contenant les fichiers de paramètres
          du Zoom Viewer. Les autres composants visuels disposent de la même
          propriété. Chaque composant visuel doit utiliser son propre dossier de
          paramètres.
        </p>

        <p>
          La valeur de cette propriété est construite à partir du chemin vers le 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 (via
          la fonction{" "}

          <strong>
            <a href="/fr/fine-reader/engine/api-reference/functions/initializeengine-function">
              InitializeEngine
            </a>
          </strong>

          {" "}

          , ou via la méthode{" "}

          <strong>
            <a href="/fr/fine-reader/engine/api-reference/engine-loaders/iengineloader/initializeengine-method">
              IEngineLoader::InitializeEngine
            </a>
          </strong>

          {" "}

          ). Le nom par défaut du sous-dossier est un GUID arbitraire. Pour
          modifier le nom du sous-dossier, vous devez indiquer 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
          contenant les 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 conserver les
          paramètres d'une session à l'autre.
        </p>
      </td>
    </tr>

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

          <strong>SymbolRect</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 du caractère actuel en pixels.
          Les coordonnées sont relatives à l'image du document.
        </p>
      </td>
    </tr>

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

          <strong>SymbolRectEnabled</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 le caractère actuel doit être encadré d'un
          rectangle jaune.
        </p>

        <p>Par défaut, la valeur est TRUE.</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{" "}

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

          {" "}

          constantes.
        </p>

        <p>
          Par défaut, la valeur est ST\_PixelToPixel, ce qui signifie que
          l'image est affichée en mode pixel par pixel.
        </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>
  </tbody>
</table>

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

| Nom                                                                                                                       | Description                                                                                                                                                                                                                                                                           |
| ------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [CenterOnDocumentPoint](/fr/fine-reader/engine/visual-components-reference/zoomviewer/centerondocumentpoint-method)       | Fait défiler la vue zoom afin que le point spécifié soit placé au centre de la vue.                                                                                                                                                                                                   |
| [DocumentToScreen](/fr/fine-reader/engine/visual-components-reference/zoomviewer/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/zoomviewer/getselectedblocksindices-method) | Renvoie la collection des indices des blocs sélectionnés.                                                                                                                                                                                                                             |
| [GetSelectedCells](/fr/fine-reader/engine/visual-components-reference/zoomviewer/getselectedcells-method)                 | Renvoie le rectangle englobant des cellules sélectionnées dans le bloc de tableau spécifié.                                                                                                                                                                                           |
| [ScreenToDocument](/fr/fine-reader/engine/visual-components-reference/zoomviewer/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/zoomviewer/setselectedblocksindices-method) | Définit la sélection des blocs.                                                                                                                                                                                                                                                       |
| [SetSelectedCells](/fr/fine-reader/engine/visual-components-reference/zoomviewer/setselectedcells-method)                 | Définit les cellules sélectionnées du bloc de tableau spécifié.                                                                                                                                                                                                                       |
| [ShowDocumentArea](/fr/fine-reader/engine/visual-components-reference/zoomviewer/showdocumentarea-method)                 | Fait défiler la vue zoom afin que la zone du document correspondant aux coordonnées spécifiées devienne visible (dans la mesure du possible).                                                                                                                                         |
| [UpdateOptions](/fr/fine-reader/engine/visual-components-reference/zoomviewer/updateoptions-method)                       | Met à jour les paramètres spécifiés dans la boîte de dialogue Options de Zoom 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 les options de Zoom 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>

[IZoomViewerEvents](/fr/fine-reader/engine/visual-components-reference/izoomviewerevents)

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

[Création d’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)