Saltar al contenido principal
Visual Components está implementado en FRE para Windows.
El objeto ImageViewer es un control ActiveX que le permite ver y editar una imagen y los bloques de esa imagen. Una imagen se conecta a Image Viewer mediante la propiedad FRPage. El componente Image Viewer tiene este aspecto: ImageViewer Puede modificar la apariencia del componente mediante sus propiedades. Por ejemplo, puede agregar botones a su barra de herramientas y quitarlos 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 visualización y edición de la imagen se transmite a través de interfaces salientes especiales. Estas interfaces son IImageViewerEvents (para C++) y la dispinterface DIImageViewerEvents (para Visual Basic). Cabe señalar que los usuarios de Visual Basic no deben preocuparse por los detalles de la implementación de las interfaces de eventos, ya que esta plataforma de desarrollo proporciona medios sencillos para gestionarlas. Este objeto puede declararse con WithEvents en Visual Basic. Para el usuario 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 IImageViewerEvents y, a continuación, establecer la conexión entre este objeto y el origen de eventos implementado en el objeto ImageViewer por medios COM estándar. El componente Image Viewer puede conectarse al componente Component Synchronizer, en cuyo caso todos los eventos de Image Viewer se transmitirán automáticamente a otros componentes conectados a Synchronizer y toda la aplicación funcionará de forma sincronizada.

Propiedades

Especifica la herramienta activa para editar bloques e imágenes.

Especifica si Image Viewer debe desplazarse por todas las páginas del documento. Si esta propiedad es FALSE, Image Viewer solo se desplaza por la página seleccionada.

De forma predeterminada, el valor es TRUE.

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

De forma predeterminada, el valor es TRUE.

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

De forma predeterminada, el valor es TRUE.

Especifica si el menú contextual de Image 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 Image Viewer. Consultela lista de comandos disponibles en Image Viewer.

Especifica la página del documento conectada a Image Viewer.

Especifica si los fragmentos reconocidos deben resaltarse en la imagen durante el reconocimiento. Esta propiedad le permite seguir el progreso del reconocimiento.

De forma predeterminada, el valor es TRUE.

Especifica si Image 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, delobjeto) y procesa mensajes de Windows de Visual Components en los manejadores de estos eventos.

En estos casos, se recomienda establecer esta propiedad en TRUE antes del análisis, reconocimiento, síntesis o exportación, y en FALSE una vez finalizada la operación. De este modo, el documento no podrá modificarse desde Image Viewer.

De forma predeterminada, el valor es FALSE.

,de solo lectura

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

Especifica los parámetros de procesamiento predeterminados para un documento. Estos parámetros se utilizan si los procesos de análisis, reconocimiento y síntesis se invocan directamente desde Image Viewer.

Si Image Viewer está conectado a Component Synchronizer, utilice la propiedadIComponentSynchronizer::ProcessingParamspara cambiar los parámetros utilizados en el procesamiento. Si cambia los parámetros de procesamiento a través de la propiedad de Image Viewer, pueden producirse errores.

Proporciona acceso a la colección de índices de las páginas seleccionadas en el cuadro de diálogo Image Editor.

Especifica la ruta a la carpeta que contiene los archivos con la configuración de Image Viewer. Los demás Visual Components tienen la misma propiedad. Cada Visual Component debe usar 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. 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 el componente se genera dinámicamente en tiempo de ejecución), el componente crea una nueva carpeta de 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 podrá usar la configuración predeterminada del componente y no será posible guardar la configuración entre sesiones.

Especifica el título del componente Image Viewer.

De forma predeterminada, es “Image”.

,de solo lectura

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

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

De forma predeterminada, el valor es ST_BestFit, lo que significa que el ajuste óptimo se selecciona automáticamente.

,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 handle de ventana del área de cliente.

Almacena las coordenadas, en píxeles, del rectángulo del área de zoom. Las coordenadas se refieren a la imagen del documento.

Especifica si el área de zoom debe marcarse en la imagen con un rectángulo de puntos.

De forma predeterminada, el valor es TRUE.

Métodos

NombreDescripción
CenterOnDocumentPointDesplaza la vista de la imagen para que el punto especificado quede situado en el centro de la vista.
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 delimitador de las celdas seleccionadas en el bloque de la tabla especificado.
PrintImprime la imagen.
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 la tabla especificado.
ShowDocumentAreaDesplaza la vista de la imagen para que el área del documento con las coordenadas especificadas sea visible (en la medida de lo posible).
UpdateOptionsActualiza la configuración especificada en el cuadro de diálogo Opciones de Image Viewer. Es posible que deba llamar a este método si las opciones se han cambiado en algún otro Visual Component, para actualizar las opciones de Image Viewer al estado actual.

Ejemplos

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

Consulte también

IImageViewerEvents IComponentSynchronizer::ImageViewer 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 Trabajo con propiedades