> ## 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 DocumentViewer (interfaz IDocumentViewer)

> Objeto DocumentViewer (interfaz IDocumentViewer) en ABBYY FineReader Engine Visual Components para Windows — El objeto DocumentViewer es un control ActiveX que le permite ver la lista de páginas del documento y...

<Warning>
  Los componentes visuales se implementan en FRE para Windows.
</Warning>

El objeto DocumentViewer es un control ActiveX que le permite ver la lista de páginas del documento y supervisar su estado. También puede guardar el documento reconocido o abrirlo en la aplicación seleccionada mediante los comandos disponibles en el componente. El documento se conecta al componente a través de la propiedad FRDocument.

El componente Document Viewer puede presentar el siguiente aspecto en función del valor de la propiedad Mode:

* Vista detallada

Proporciona información detallada sobre cada página del documento.

<img src="https://mintcdn.com/abbyy/lsETHFYUFiongXSm/images/fine-reader/engine/documentviewer_details.gif?s=17b7a922309b41af5818b19c3b5900ea" alt="DocumentViewer_Details" width="642" height="174" data-path="images/fine-reader/engine/documentviewer_details.gif" />

* Vista en miniaturas

Muestra las páginas del documento como miniaturas.

<img src="https://mintcdn.com/abbyy/lsETHFYUFiongXSm/images/fine-reader/engine/documentviewer_thumbnails.gif?s=ea87d01ff27d7509886b17a0dbe3ad48" alt="DocumentViewer_Thumbnails" width="302" height="217" data-path="images/fine-reader/engine/documentviewer_thumbnails.gif" />

Puede modificar la apariencia del componente mediante sus propiedades. Por ejemplo, puede agregar y quitar botones de su barra de herramientas mediante la propiedad Toolbar, o modificar el menú contextual del componente mediante la propiedad PopupMenu. Consulte [Personalización del menú contextual y la barra de herramientas de un Visual Component](/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 supervisión del documento se transmite a través de interfaces salientes especiales. Estas interfaces son [IDocumentViewerEvents](/es/fine-reader/engine/visual-components-reference/idocumentviewerevents) (para C++) y una dispinterface [DIDocumentViewerEvents](/es/fine-reader/engine/visual-components-reference/idocumentviewerevents) (para Visual Basic).

Cabe señalar que los usuarios de Visual Basic no tienen que preocuparse por los detalles de implementación de las interfaces de eventos, ya que esta plataforma de desarrollo proporciona medios sencillos para gestionarlos. Este objeto puede declararse como 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 IDocumentViewerEvents y, a continuación, establecer la conexión entre dicho objeto y el origen de eventos implementado en el objeto DocumentViewer por medios COM estándar.

El componente Document Viewer puede conectarse al componente [Component Synchronizer](/es/fine-reader/engine/visual-components-reference/supplementary-objects/componentsynchronizer), en cuyo caso todos los eventos de Document 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="activepage" />

          <strong>ActivePage</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>
          Especifica la página activa en Document Viewer. Si no hay ninguna
          página activa, el valor de esta propiedad es 0.
        </p>
      </td>
    </tr>

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

          <strong>CaptionPaneEnabled</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 de título de Document Viewer está habilitado. Si
          esta propiedad es FALSE, el panel de título 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 Document 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">
            de solo lectura
          </a>
        </p>
      </td>

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

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

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

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

          <strong>FRDocument</strong>
        </p>
      </td>

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

      <td>
        <p>Especifica el documento conectado a Document Viewer.</p>
      </td>
    </tr>

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

          <strong>LanguagePaneEnabled</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 la página de idioma de Document Viewer está habilitada. Si
          esta propiedad es FALSE, la página de idioma no se muestra.
        </p>

        <p>De forma predeterminada, el valor es TRUE.</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 Document 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>
            la aplicación recibe notificaciones de determinados 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 de
          realizar el análisis, reconocimiento, síntesis o exportación, y establecerla en FALSE una vez
          finalizada la operación. De este modo, el documento no podrá corromperse
          desde Document Viewer.
        </p>

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

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

          <strong>Mode</strong>
        </p>
      </td>

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

      <td>
        <p>
          Especifica el modo actual de Document Viewer: vista de Detalles o de Miniaturas.
        </p>

        <p>De forma predeterminada, el modo es DVM\_Thumbnails.</p>
      </td>
    </tr>

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

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

      <td>
        <p>
          <strong>
            <a href="/es/fine-reader/engine/visual-components-reference/supplementary-objects/popupmenu">
              PopupMenu
            </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>Proporciona acceso a la configuración del menú contextual.</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
          parameters are used if the analysis and recognition processes are
          called directly from Document Viewer.
        </p>

        <Note>
          If Document Viewer is connected to Component Synchronizer, use the{" "}

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

          {" "}

          property to change parameters used for processing. If you change
          processing parameters via the property of Document Viewer, errors may
          occur.
        </Note>
      </td>
    </tr>

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

          <strong>Title</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 el título del componente Document Viewer.</p>
        <p>Por defecto, es «Páginas».</p>
      </td>
    </tr>

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

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

      <td>
        <p>
          <strong>
            <a href="/es/fine-reader/engine/visual-components-reference/supplementary-objects/toolbar">
              Toolbar
            </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>Proporciona acceso a la configuración de la barra de herramientas.</p>
      </td>
    </tr>

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

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

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

      <td>
        <p>Proporciona acceso a la colección de índices de las páginas seleccionadas.</p>
      </td>
    </tr>

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

          <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 Document Viewer. Otros componentes visuales tienen la misma
          propiedad. Cada componente visual debe usar su propia carpeta con
          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. Por defecto, 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>

          . Se puede cambiar durante la inicialización de FineReader Engine (mediante
          la{" "}

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

          {" "}

          función, o mediante el{" "}

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

          {" "}

          método). 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 durante el diseño. Si
          intenta especificar el valor de la propiedad en tiempo de ejecución, este valor
          se ignora.
        </p>

        <p>
          Si agrega el componente a un formulario en Visual Studio durante el diseño,
          el valor de la propiedad se define ya sea 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 alguna razón 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 el componente. Para evitar
          la multiplicación de las carpetas, debe eliminar la carpeta de configuración
          creada después de la desinicialización del componente. En este caso, solo puede usar
          la configuración predeterminada del componente y no puede guardar la
          configuración entre sesiones.
        </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 del cliente.</p>
      </td>
    </tr>
  </tbody>
</table>

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

| Nombre                                                                                                  | Descripción                                                                                                                                                                                                                                                             |
| ------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [UpdateOptions](/es/fine-reader/engine/visual-components-reference/documentviewer/updateoptions-method) | Actualiza la configuración especificada en el cuadro de diálogo Opciones de Document Viewer. Puede que tenga que llamar a este método si las opciones se han cambiado en algún otro Visual Component, para actualizar las opciones de Document Viewer al estado actual. |

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

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

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

[IDocumentViewerEvents](/es/fine-reader/engine/visual-components-reference/idocumentviewerevents)

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

[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)