Exemplo - Field Assist

Introdução

O exemplo do Field Assist demonstra como utilizar o suporte disponibilizado em org.eclipse.jface.fieldassist para fornecer assistência de tarefa nos campos de texto. Uma caixa de diálogo de exemplo demonstra como configurar decorações de campo para indicar campos obrigatórios, campos com erros e avisos, e campos que disponibilizam assistência de conteúdo. O exemplo inclui igualmente uma página de preferências que lhe permite configurar as decorações e o suporte de assistência de conteúdo.

Executar o exemplo

Quando o conector está instalado, deverá visualizar uma acção FieldAssist na barra de acções. Seleccione o artigo de menu "Open Field Assist Dialog..." Isto vai lançar a caixa de diálogo field assist. A caixa de diálogo pode ser configurada utilizando as preferências do exemplo.

Definir as Preferências Field Assist

São fornecidas duas páginas de preferências para configurar o modo como a caixa de diálogo se comporta. A página Field Assist Example Preferences permite configurar a forma como o diálogo anota campos com erros e avisos, campos requeridos e assistência de conteúdo. Pode ser utilizada uma combinação de cores e decorações para anotar os campos. Esta página de preferências pretende mostrar as possibilidades disponíveis ao configurar decorações. Está mais voltada para o programador que experimenta o field assist, não tendo pretensões de ser um exemplo de uma boa página de preferências para deixar os utilizadores finais controlar as anotações.

A página Content Assist Preferences permite-lhe configurar a forma como a assistência de conteúdo é instalada no campo de texto da caixa de diálogo. A maioria das opções fornecidas na API field assist (ContentProposalAdapter) são configuráveis nesta página. Repare que é possível configurar a assistência de conteúdos para uma experiência de utilizador indesejável. Por exemplo, definir a assistência de conteúdo para fazer a auto-activação em todos os caracteres utilizando um diferimento prolongado, não é desejável. Pode ser confuso utilizar filtragem de propostas cumulativa quando as chaves de filtro não são devolvidas ao controlo. O objectivo de expor a API na página de preferências é permitir que o programador de field assist experimente todas as combinações possíveis. Não está previsto que qualquer destas preferências seja, alguma vez, exposta a um utilizador final, mas sim que o programador escolha a melhor combinação destes valores para proporcionar um determinado estilo de assistência de conteúdos.

Utilizar a caixa de diálogo

A caixa de diálogo de exemplo mostra vários tipos de campos diferentes:

Exemplo de código fonte

A caixa de diálogo de exemplo não é muito complexa, mas pretende demonstrar como programar field assist. Seguem-se algumas notas relativas ao código fonte: