Ejemplo - Asistencia de campo

Introducción

El ejemplo de asistencia de campo muestra cómo utilizar el soporte proporcionado en org.eclipse.jface.fieldassist para proporcionar asistencia de tareas en campos de texto. Un diálogo de ejemplo muestra cómo configurar la decoraciones de campo para indicar campos necesarios, campos con errores y avisos y campos que proporcionan asistencia de contenido. El ejemplo también incluye una página de preferencias que permite configurar las decoraciones y el soporte de la asistencia de contenido.

Ejecución del ejemplo

Cuando el plug-in está instalado, debe ver una acción FieldAssist en la barra de acciones. Elija el elemento de menú "Abrir diálogo de asistencia de campo..." Esto abrirá el diálogo de asistencia de campo. El diálogo puede configurarse utilizando las preferencias del ejemplo.

Establecer preferencias de asistencia de campo

Hay dos páginas de preferencias para configurar la forma en que se comporta el diálogo. La página Preferencias de asistencia de campo permite configurar cómo el diálogo realiza anotaciones en los campos errores y avisos, campos necesarios y asistencia de contenido. Puede utilizarse una combinación de colores y decoraciones para anotar en los campos. Esta página de preferencias pretende mostrarle las posibilidades de la configuración de decoraciones. Está dirigida a la elección de la asistencia de campo por parte del programador y no pretende ser un ejemplo de una buena página de preferencias que permita a los usuarios finales controlar las anotaciones.

La página Preferencias de asistencia de contenido permite configurar cómo se instala la asistencia de contenido en el campo de texto del diálogo. La mayoría de las opciones proporcionadas en la API de asistencia de campo (ContentProposalAdapter) pueden configurarse en esta página. Tenga en cuenta que es posible configurar la asistencia de contenido de forma que la experiencia del usuario no sea la deseable. Por ejemplo, establecer que la asistencia de contenido se active en todos los caracteres utilizando un largo retardo no es deseable. Puede resultar confuso utilizar el filtrado de propuestas acumulativo cuando las claves del filtro no se devuelven al control. El propósito de exponer la API en la página de preferencias es permite que el programador de la asistencia de campo intente todas las posibles combinaciones. No se espera que ninguna de estas preferencias se exponga nunca a un usuario final, debe ser el desarrollador quien elija la mejor combinación de estos valores para proporcionar un determinado estilo de asistencia de contenido.

Utilizar el diálogo

El diálogo de ejemplo muestra diferentes clases de campos:

Código fuente de ejemplo

El diálogo de ejemplo no es muy complejo, pero se pretende demostrar cómo programar la asistencia de campo. A continuación se proporcionan algunas notas acerca del código fuente: