Saltar al contenido principal
Los Componentes visuales están implementados en FRE 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 que se está editando en ese momento. Mientras que Image Viewer 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: ZoomViewer Puede modificar la apariencia del componente mediante sus propiedades. Por ejemplo, puede modificar el menú contextual del componente mediante la propiedad Commands. Consulte 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 (para C++) y la dispinterface DIZoomViewerEvents (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; 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.

Propiedades

Especifica la herramienta activa para la edición de bloques e imágenes.

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

De forma predeterminada, el valor es TRUE.

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

De forma predeterminada, el valor es TRUE.

,read-only

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

Representa la página del documento conectada a Zoom Viewer.

Especifica si Zoom 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
  • su aplicación recibe notificaciones de ciertos 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 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.

De forma predeterminada, el valor es FALSE.

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.

Si Zoom Viewer está conectado a Component Synchronizer, utilice la propiedadIComponentSynchronizer::ProcessingParamspara 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.

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.

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 lacarpeta de datos de FineReader Engine. Puede modificarse durante la inicialización de FineReader Engine (mediante la funcióno mediante el 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 en tiempo de diseño. Si intenta especificar el valor de la propiedad en tiempo de ejecución, dicho valor se ignorará.

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.

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

Especifica si el carácter actual debe marcarse con un rectángulo amarillo.

De forma predeterminada, el valor es TRUE.

Especifica la escala de la imagen en puntos porcentuales. Esta propiedad también puede establecerse en una de lasconstantes.

De forma predeterminada, el valor es ST_PixelToPixel, lo que significa que la imagen se muestra en modo píxel a píxel.

,de solo lectura

Almacena las coordenadas del área visible del documento en píxeles. Las coordenadas son relativas a la imagen del documento.

, de solo lectura

Devuelve el identificador de ventana del área de cliente.

Métodos

NombreDescripción
CenterOnDocumentPointDesplaza la vista para que el punto especificado quede centrado.
DocumentToScreenConvierte las coordenadas del punto especificado en la imagen del documento en coordenadas de pantalla.
GetSelectedBlocksIndicesDevuelve la colección de índices de los bloques seleccionados.
GetSelectedCellsDevuelve el rectángulo que rodea las celdas seleccionadas en el bloque de tabla especificado.
ScreenToDocumentConvierte las coordenadas de pantalla del punto especificado en coordenadas de la imagen del documento.
SetSelectedBlocksIndicesEstablece la selección de bloques.
SetSelectedCellsEstablece las celdas seleccionadas del bloque de tabla especificado.
ShowDocumentAreaDesplaza la vista para que el área del documento con las coordenadas especificadas quede visible (en la medida de lo posible).
UpdateOptionsActualiza 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.

Ejemplos

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

Consulte también

IZoomViewerEvents IComponentSynchronizer::ZoomViewer 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