Saltar al contenido principal
Visual Components está implementado en FRE para Windows.
El objeto TextEditor es un control ActiveX que le permite ver y editar el texto reconocido en una página de un documento. Una página se conecta al componente mediante la propiedad FRPage. El componente Text Editor tiene este aspecto: TextEditor 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 Commands. Consulte Personalización del menú contextual y la barra de herramientas de un Visual Component para obtener más información. La información sobre la edición del texto reconocido se transmite a través de interfaces salientes especiales. Estas interfaces son ITextEditorEvents (para C++) y una dispinterface DITextEditorEvents (para Visual Basic). Cabe señalar que los usuarios de Visual Basic no necesitan preocuparse por los detalles de implementación de las interfaces de eventos, ya que esta plataforma de desarrollo proporciona mecanismos sencillos para controlarlas. Este objeto puede declararse con WithEvents en Visual Basic. Para el usuario de C++, esto significa que admite la interfaz IConnectionPointContainer. Para recibir notificaciones de eventos, un usuario de C++ debe crear un objeto derivado de la interfaz ITextEditorEvents y, a continuación, establecer la conexión entre este y el origen de eventos implementado en el objeto TextEditor mediante los mecanismos COM estándar. El componente Text Editor puede conectarse al componente Component Synchronizer; en ese caso, todos los eventos de Text Editor se transmitirán automáticamente a otros componentes conectados al Synchronizer y toda la aplicación funcionará de forma sincronizada.

Propiedades

Especifica si el panel inferior del Text Editor 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 título del Text Editor 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 del Text Editor 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 Text Editor. Consultela lista de comandos disponibles en Text Editor.

Especifica la posición del cursor en la página.

Representa la página del documento conectada al Text Editor.

Especifica si los colores del texto y del fondo deben conservarse en el Text Editor.

De forma predeterminada, el valor de esta propiedad es TRUE.

Especifica si el Text Editor 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 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á modificarse desde el Text Editor.

De forma predeterminada, el valor es FALSE.

Especifica uno de los modos de visualización del documento.

De forma predeterminada, el valor es TEM_ExactCopy.

,read-only

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

Especifica la ruta a la carpeta que contiene los archivos con la configuración del Editor de texto. 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 (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 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 puede usar la configuración predeterminada del componente y no es posible guardar la configuración entre sesiones.

Especifica si las imágenes deben mostrarse en el Editor de texto.

De forma predeterminada, el valor de esta propiedad es TRUE.

Especifica si los títulos corrientes deben mostrarse en el Editor de texto.

De forma predeterminada, el valor de esta propiedad es TRUE.

Especifica los parámetros de síntesis predeterminados para un documento. Estos parámetros se utilizan cuando el Editor de texto necesita realizar la síntesis del documento (esto puede ocurrir si la estructura lógica de un documento queda incorrecta a causa de ciertas operaciones de edición).

Si el Editor de texto está conectado al Sincronizador de componentes, use la propiedadIComponentSynchronizer::ProcessingParamspara cambiar los parámetros utilizados en la síntesis del documento. Si cambia estos parámetros mediante la propiedad del Editor de texto, pueden producirse errores.

,read-only

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

Especifica el título del componente Editor de texto.

De forma predeterminada, es “Text”.

,read-only

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

Especifica la escala de la página de texto en puntos porcentuales. Esta propiedad también puede establecerse en una de las constantes deconstants.

De forma predeterminada, el valor es ST_BestFit, lo que significa que el mejor ajuste 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 identificador de ventana del área de cliente.

Métodos

NombreDescripción
ActivateOnActiva una posición en el bloque especificado y la desplaza hasta hacerla visible.
CenterOnDocumentPointDesplaza la vista de texto para que el punto del documento especificado quede situado en el centro de la vista.
DocumentToScreenConvierte las coordenadas del punto especificado en la imagen del documento en coordenadas de pantalla.
GetSelectionDevuelve las posiciones inicial y final del cursor de la selección.
PrintImprime el texto reconocido.
SetSelectionEstablece la selección de texto en una página.
ScreenToDocumentConvierte las coordenadas de pantalla del punto especificado en coordenadas de la imagen del documento.
ShowBlockDesplaza el bloque especificado hasta hacerlo visible (en la medida de lo posible). Este método solo tiene sentido si el Text Editor se usa en el modo TEM_ExactCopy.
ShowDocumentAreaDesplaza la vista de texto para que el área del documento con las coordenadas especificadas pase a ser visible (en la medida de lo posible).
UpdateOptionsActualiza la configuración especificada en el cuadro de diálogo Opciones del Text Editor. Puede que sea necesario llamar a este método si las opciones se han cambiado en algún otro Visual Component, para actualizar las opciones del Text Editor al estado actual.

Ejemplos

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

Consulte también

ITextEditorEvents IComponentSynchronizer::TextEditor Crear una aplicación con interfaz gráfica de usuario Personalizar el menú contextual y la barra de herramientas de un Visual Component