Editores de texto y texto JFace
El paquete de entorno de trabajo org.eclipse.ui.editors.text
implementa el editor de texto por omisión para la plataforma. Utiliza la infraestructura de editores de texto en org.eclipse.ui.texteditor
para su implementación.
La infraestructura de editores de texto proporciona un editor independiente del modelo de dominio que soporta las características siguientes:
- Operaciones de edición de texto estándar, como cortar/copiar/pegar, buscar/sustituir
- Presentación visual de marcadores de recursos adyacentes al área de edición de texto
- Actualización automática de marcadores de recursos a medida que el usuario edita texto
- Gestión de menús de contexto
- Respuestas a acciones del usuario en el entorno de trabajo, como la renovación de recursos desde el sistema de archivos, el cierre de proyectos o la sustitución del recurso de elementos de entrada del editor
ITextEditor
está definido como una extensión específica de texto de IEditorPart.
La implementación por omisión de esta interfaz la proporciona AbstractTextEditor.
IDocumentProvider
se utiliza para establecer el enlace entre un modelo de dominio y un ITextEditor.
El suministrador de documentos gestiona la presentación del texto del modelo de dominio y puede compartirse entre varios editores.
La infraestructura de edición de texto de entorno de trabajo se construye al principio del texto JFace. El ejemplo del editor de Java en org.eclipse.ui.examples.javaeditor
es idóneo para empezar a interpretar la infraestructura de editores de texto y del texto JFace. Muestra cómo pueden implementarse características complejas como, por ejemplo, el color del texto, la ayuda flotante y el sangrado automático.
Texto JFace
El paquete org.eclipse.jface.text
y sus subpaquetes soportan la implementación de editores de texto sólidos, como el editor de texto de entorno de trabajo y el editor JDT de Java.
El mapa siguiente proporciona una visión general de lo que el texto JFace soporta.
- org.eclipse.jface.text
define un modelo de documento genérico para texto y proporciona un visor que visualiza texto utilizando este modelo. Los documentos pueden dividirse en particiones que no se solapan, lo cual puede resultar satisfactorio cuando el texto representa múltiples elementos con diferentes significados (como métodos y comentarios dentro de un archivo Java). Las particiones tienen tipos de contenido, que se utilizan para identificar lugares donde debe asignarse un funcionamiento distinto para diferentes tipos de contenido. Las posiciones del documento pueden utilizarse para definir regiones de texto que permanecen actualizadas a medida que el usuario edita texto. IDocument
y TextViewer
son los lugares idóneos para empezar interpretar este paquete.
- org.eclipse.jface.text.formatter
define una parte adicional del visor de texto que puede configurarse con una función de formato distinta para cada tipo de contenido de partición. El formato se obtiene manipulando espacios en blanco y delimitadores a fin de presentar el texto de manera estructurada. El formato se utiliza con mayor frecuencia cuando se edita código y suele manejarlo el usuario según sus preferencias. El editor de código fuente de JDT utiliza este soporte para proporcionar formato de código Java manejado por el usuario.
- org.eclipse.jface.text.contentassist
define un parte adicional del visor de texto que proporciona soporte de finalización de texto manejado por el usuario. Se utilizan ventanas emergentes para proponer posibles opciones de texto para completar una frase. El usuario puede seleccionar estas opciones de manera que se inserten automáticamente en el texto. La ayuda de contenido también soporta ventanas emergentes contextualizadas a fin de proporcionar al usuario la información relacionada con la posición actual en el documento. IContentAssistant
es el lugar idóneo para la interpretación de este paquete. Puede configurarse con diferentes procedimientos de finalización de frases para distintos tipos de contenido de partición.
- org.eclipse.jface.text.presentation
define una parte adicional del visor de texto que puede controlar
la presentación visual (font, estilo de font, colores) del texto que se muestra en el visor de texto. Para cada cambio que se aplica en un documento, el conciliador de
presentación determina qué parte de la presentación visual debe invalidarse y cómo repararla. Se pueden utilizar diferentes procedimientos para distintos tipos de contenido de partición.
- org.eclipse.jface.text.reconciler
define una parte adicional del visor de texto que soporta la sincronización de un documento con cierta estructura externa que también podría estar manipulando el texto.
- org.eclipse.jface.text.rules
proporciona exploración de documentos basados en normas. Los conectores pueden utilizar normas para distinguir símbolos, como delimitadores de líneas, espacios en blanco y patrones genéricos, cuando se explora un documento. Este paquete también soporta partición de documentos y adaptación de presentaciones controlada por normas. El ejemplo del editor de Java utiliza este paquete para analizar código Java.
- org.eclipse.jface.text.source
define a visor de fuente. Un visor de fuente amplía un visor de texto a fin de soportar anotaciones de texto visuales. Estas anotaciones se
utilizan en el código fuente de JDT para anotar descripciones de problemas y puntos de interrupción en el código fuente Java.
El soporte de texto de JFace utiliza el widget StyledText
de SWT.
