Saltar al contenido principal
Los componentes visuales se implementan en FRE para Windows.
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. DocumentViewer_Details
  • Vista en miniaturas
Muestra las páginas del documento como miniaturas. DocumentViewer_Thumbnails 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 componente visual 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 (para C++) y una dispinterface DIDocumentViewerEvents (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, 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.

Propiedades

Especifica la página activa en Document Viewer. Si no hay ninguna página activa, el valor de esta propiedad es 0.

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.

De forma predeterminada, el valor es TRUE.

Especifica si el menú contextual de Document Viewer está habilitado. Si esta propiedad es FALSE, el menú contextual nunca se muestra.

De forma predeterminada, el valor es TRUE.

,de solo lectura

Proporciona acceso a los comandos disponibles en Document Viewer. Consultela lista de comandos disponibles en Document Viewer.

Especifica el documento conectado a Document Viewer.

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.

De forma predeterminada, el valor es TRUE.

Especifica si Document Viewer está bloqueado.

Esta propiedad resulta útil en las siguientes situaciones:

  • 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
  • la aplicación recibe notificaciones de determinados eventos (por ejemplo, del objeto) y procesa mensajes de Windows de Visual Components en los controladores de dichos eventos.

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.

De forma predeterminada, el valor es FALSE.

Especifica el modo actual de Document Viewer: vista de Detalles o de Miniaturas.

De forma predeterminada, el modo es DVM_Thumbnails.

,de solo lectura

Proporciona acceso a la configuración del menú contextual.

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.

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.

Especifica el título del componente Document Viewer.

Por defecto, es «Páginas».

,de solo lectura

Proporciona acceso a la configuración de la barra de herramientas.

Proporciona acceso a la colección de índices de las páginas seleccionadas.

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.

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 lacarpeta de datos de FineReader Engine. Se puede cambiar durante la inicialización de FineReader Engine (mediante lafunción, o mediante elmé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.

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.

, de solo lectura

Devuelve el identificador de ventana del área del cliente.

Métodos

NombreDescripción
UpdateOptionsActualiza 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.

Ejemplos

Este componente se utiliza en los siguientes ejemplos de código: VisualComponents.

Consulte también

IDocumentViewerEvents IComponentSynchronizer::DocumentViewer Creación de una aplicación con interfaz gráfica de usuario Personalización del menú contextual y la barra de herramientas de un componente visual