> ## 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.

# Objeto ZoomViewer (interfaz IZoomViewer)

> Objeto ZoomViewer (interfaz IZoomViewer) en ABBYY FineReader Engine Visual Components para Windows: el objeto ZoomViewer es un control ActiveX que permite ver una imagen ampliada de la línea o del área de la imagen procesada...

<Warning>
  Los Componentes visuales están implementados en FRE para Windows.
</Warning>

El objeto ZoomViewer es un control ActiveX que permite ver una imagen ampliada de la línea o del área de la imagen procesada que se está editando en ese momento. Mientras que [Image Viewer](/es/fine-reader/engine/visual-components-reference/imageviewer) muestra la vista general de la página, Zoom Viewer ofrece una forma sencilla de ver la imagen con mayor detalle, ajustar la posición del área o comparar caracteres dudosos con la imagen ampliada. Una imagen se conecta a Zoom Viewer mediante la propiedad FRPage.

El componente Zoom Viewer tiene este aspecto:

<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" />

Puede modificar la apariencia del componente mediante sus propiedades. Por ejemplo, puede modificar el menú contextual del componente mediante la propiedad Commands. Consulte [personalización del menú contextual y la barra de herramientas de un componente visual](/es/fine-reader/engine/guided-tour/advanced-techniques/using-gui-elements/customizing-the-context-menu-and-toolbar-of-a-visual-component) para obtener más información.

La información sobre la visualización de una imagen se transmite a través de interfaces de salida especiales. Estas interfaces son [IZoomViewerEvents](/es/fine-reader/engine/visual-components-reference/izoomviewerevents) (para C++) y la dispinterface [DIZoomViewerEvents](/es/fine-reader/engine/visual-components-reference/izoomviewerevents) (para Visual Basic).

Cabe destacar que los usuarios de Visual Basic no deben preocuparse por los detalles de implementación de las interfaces de eventos, ya que esta plataforma de desarrollo ofrece mecanismos sencillos para gestionarlas. Este objeto puede declararse con WithEvents en Visual Basic.

Para los usuarios de C++, esto significa que admite la interfaz IConnectionPointContainer. Para recibir eventos de notificación, un usuario de C++ debe crear un objeto derivado de la interfaz IZoomViewerEvents y, a continuación, establecer la conexión entre este y el origen de eventos implementado en el objeto ZoomViewer por medios COM estándar.

El componente Zoom Viewer puede conectarse al componente [Component Synchronizer](/es/fine-reader/engine/visual-components-reference/supplementary-objects/componentsynchronizer); en ese caso, todos los eventos de Zoom Viewer se transmitirán automáticamente a otros componentes conectados al Synchronizer, y toda la aplicación funcionará de forma síncrona.

<div id="properties">
  ## Propiedades
</div>

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

      <th>
        <p>
          <strong>Tipo</strong>
        </p>
      </th>

      <th>
        <p>
          <strong>Descripción</strong>
        </p>
      </th>
    </tr>
  </thead>

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

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

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

      <td>
        <p>Especifica la herramienta activa para la edición de bloques e imágenes.</p>
      </td>
    </tr>

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

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

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

      <td>
        <p>
          Especifica si el panel inferior de Zoom Viewer está habilitado. Si esta
          propiedad es FALSE, el panel inferior no se muestra.
        </p>

        <p>De forma predeterminada, el valor es TRUE.</p>
      </td>
    </tr>

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

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

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

      <td>
        <p>
          Especifica si el menú contextual de Zoom Viewer está habilitado. Si esta
          propiedad es FALSE, el menú contextual nunca se muestra.
        </p>

        <p>De forma predeterminada, el valor es TRUE.</p>
      </td>
    </tr>

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

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

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

          ,{" "}

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

      <td>
        <p>
          Proporciona acceso a los comandos disponibles en Zoom Viewer. Consulte{" "}

          <a href="/es/fine-reader/engine/visual-components-reference/zoomviewer/zoom-viewer-commands">
            la lista de comandos disponibles en Zoom Viewer
          </a>

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

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

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

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

      <td>
        <p>Representa la página del documento conectada a Zoom Viewer.</p>
      </td>
    </tr>

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

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

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

      <td>
        <p>Especifica si Zoom Viewer está bloqueado.</p>
        <p>Esta propiedad resulta útil en las siguientes situaciones:</p>

        <ul>
          <li>
            se invoca una operación de análisis, reconocimiento, síntesis o exportación desde
            la API de FineReader Engine (no desde Visual Components), o
          </li>

          <li>
            su aplicación recibe notificaciones de ciertos eventos (por ejemplo,
            del objeto

            <strong>
              {" "}

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

              {" "}
            </strong>

            ) y procesa mensajes de Windows de Visual Components en
            los controladores de dichos eventos.
          </li>
        </ul>

        <p>
          En este caso, se recomienda establecer esta propiedad en TRUE antes del
          análisis, reconocimiento, síntesis o exportación, y en FALSE al
          finalizar la operación. De este modo, el documento no podrá ser alterado
          desde Zoom Viewer.
        </p>

        <p>De forma predeterminada, el valor es FALSE.</p>
      </td>
    </tr>

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

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

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

      <td>
        <p>
          Especifica los parámetros de procesamiento predeterminados para el documento. Estos
          parámetros se utilizan cuando los procesos de análisis y reconocimiento se
          invocan directamente desde Zoom Viewer.
        </p>

        <Note>
          Si Zoom Viewer está conectado a Component Synchronizer, utilice la propiedad{" "}

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

          {" "}

          para modificar los parámetros de procesamiento. Si cambia los
          parámetros de procesamiento a través de la propiedad de Zoom Viewer, pueden
          producirse errores.
        </Note>
      </td>
    </tr>

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

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

      <td>
        <p>
          Especifica la ruta a la carpeta que contiene los archivos con la
          configuración de Zoom Viewer. Los demás Visual Components tienen la misma
          propiedad. Cada Visual Component debe utilizar su propia carpeta de
          configuración.
        </p>

        <p>
          El valor de esta propiedad se construye a partir de la ruta a la carpeta
          en la que ABBYY FineReader Engine almacena los datos específicos del usuario y el
          nombre de su subcarpeta. De forma predeterminada, la carpeta con datos específicos del usuario
          es la{" "}

          <a href="/es/fine-reader/engine/distribution/distribution-windows/distribution-kit#finereader_engine_data_folder">
            carpeta de datos de FineReader Engine
          </a>

          . Puede modificarse durante la inicialización de FineReader Engine (mediante
          la función{" "}

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

          {" "}

          o mediante el método{" "}

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

          {" "}

          ). El nombre predeterminado de la subcarpeta es un GUID arbitrario. Para
          cambiar el nombre de la subcarpeta, debe especificar el nuevo nombre en
          las propiedades del componente en Visual Studio en tiempo de diseño. Si
          intenta especificar el valor de la propiedad en tiempo de ejecución, dicho valor
          se ignorará.
        </p>

        <p>
          Si agrega el componente a un formulario en Visual Studio durante el diseño,
          el valor de la propiedad se define automáticamente con el valor
          predeterminado o manualmente con un valor personalizado. En ambos casos, el
          valor se define en tiempo de diseño. Si por algún motivo el valor de la
          propiedad no se define en tiempo de diseño (por ejemplo, si genera el
          componente dinámicamente en tiempo de ejecución), el componente crea una nueva carpeta
          con la configuración cada vez que se inicializa. Para evitar
          la proliferación de carpetas, debe eliminar la carpeta de configuración creada
          tras la desinicialización del componente. En este caso, solo puede usar
          la configuración predeterminada del componente y no podrá guardar la
          configuración entre sesiones.
        </p>
      </td>
    </tr>

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

          <strong>SymbolRect</strong>
        </p>
      </td>

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

      <td>
        <p>
          Almacena las coordenadas del rectángulo del carácter actual en píxeles.
          Las coordenadas son relativas a la imagen del documento.
        </p>
      </td>
    </tr>

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

          <strong>SymbolRectEnabled</strong>
        </p>
      </td>

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

      <td>
        <p>
          Especifica si el carácter actual debe marcarse con un rectángulo
          amarillo.
        </p>

        <p>De forma predeterminada, el valor es TRUE.</p>
      </td>
    </tr>

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

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

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

      <td>
        <p>
          Especifica la escala de la imagen en puntos porcentuales. Esta propiedad
          también puede establecerse en una de las{" "}

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

          {" "}

          constantes.
        </p>

        <p>
          De forma predeterminada, el valor es ST\_PixelToPixel, lo que significa que la
          imagen se muestra en modo píxel a píxel.
        </p>
      </td>
    </tr>

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

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

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

          ,{" "}

          <a href="/es/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties#readonly_properties">
            de solo lectura
          </a>
        </p>
      </td>

      <td>
        <p>
          Almacena las coordenadas del área visible del documento en píxeles. Las
          coordenadas son relativas a la imagen del documento.
        </p>
      </td>
    </tr>

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

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

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

          , de solo lectura
        </p>
      </td>

      <td>
        <p>Devuelve el identificador de ventana del área de cliente.</p>
      </td>
    </tr>
  </tbody>
</table>

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

| Nombre                                                                                                                    | Descripción                                                                                                                                                                                                                                                    |
| ------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [CenterOnDocumentPoint](/es/fine-reader/engine/visual-components-reference/zoomviewer/centerondocumentpoint-method)       | Desplaza la vista para que el punto especificado quede centrado.                                                                                                                                                                                               |
| [DocumentToScreen](/es/fine-reader/engine/visual-components-reference/zoomviewer/documenttoscreen-method)                 | Convierte las coordenadas del punto especificado en la imagen del documento en coordenadas de pantalla.                                                                                                                                                        |
| [GetSelectedBlocksIndices](/es/fine-reader/engine/visual-components-reference/zoomviewer/getselectedblocksindices-method) | Devuelve la colección de índices de los bloques seleccionados.                                                                                                                                                                                                 |
| [GetSelectedCells](/es/fine-reader/engine/visual-components-reference/zoomviewer/getselectedcells-method)                 | Devuelve el rectángulo que rodea las celdas seleccionadas en el bloque de tabla especificado.                                                                                                                                                                  |
| [ScreenToDocument](/es/fine-reader/engine/visual-components-reference/zoomviewer/screentodocument-method)                 | Convierte las coordenadas de pantalla del punto especificado en coordenadas de la imagen del documento.                                                                                                                                                        |
| [SetSelectedBlocksIndices](/es/fine-reader/engine/visual-components-reference/zoomviewer/setselectedblocksindices-method) | Establece la selección de bloques.                                                                                                                                                                                                                             |
| [SetSelectedCells](/es/fine-reader/engine/visual-components-reference/zoomviewer/setselectedcells-method)                 | Establece las celdas seleccionadas del bloque de tabla especificado.                                                                                                                                                                                           |
| [ShowDocumentArea](/es/fine-reader/engine/visual-components-reference/zoomviewer/showdocumentarea-method)                 | Desplaza la vista para que el área del documento con las coordenadas especificadas quede visible (en la medida de lo posible).                                                                                                                                 |
| [UpdateOptions](/es/fine-reader/engine/visual-components-reference/zoomviewer/updateoptions-method)                       | Actualiza la configuración especificada en el cuadro de diálogo Opciones de Zoom Viewer. Puede que tenga que llamar a este método si las opciones se han modificado en otro componente visual, para actualizar las opciones de Zoom Viewer a su estado actual. |

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

Este componente se usa en los siguientes ejemplos de código: [VisualComponents](/es/fine-reader/engine/guided-tour/samples#visualcomponents).

<div id="see-also">
  ## Consulte también
</div>

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

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

[Creación de una aplicación con interfaz gráfica de usuario](/es/fine-reader/engine/guided-tour/advanced-techniques/using-gui-elements/creating-an-application-with-gui)

[Personalización del menú contextual y la barra de herramientas de un componente visual](/es/fine-reader/engine/guided-tour/advanced-techniques/using-gui-elements/customizing-the-context-menu-and-toolbar-of-a-visual-component)