Exemplo - Assistente de Campo

Introdução

O exemplo de Assistente de Campo mostra como utilizar o suporte fornecido no org.eclipse.jface.fieldassist para oferecer ajuda para tarefas nos campos de texto. Um diálogo de exemplo mostra como configurar decorações de campo para indicar campos obrigatórios, campos com erros e avisos e campos que fornecem assistência de conteúdo. O exemplo inclui também uma página de preferências que permite configurar as decorações e o suporte para assistente de conteúdo.

Executando o Exemplo

Quando o plug-in estiver instalado, consulte uma ação FieldAssist, na barra de ação. Escolha o item de menu "Abrir Diálogo do Assistente de Campo..." Isso ativará o diálogo do assistente de campo. O diálogo pode ser configurado utilizando as preferências de exemplo.

Definindo Preferências do Assistente de Campo

Duas páginas de preferências são fornecidas para configurar o comportamento do diálogo. A página Preferências de Exemplo de Assistente de Campo permite configurar o modo como o diálogo anota campos com erros e avisos, campos obrigatórios e assistente de conteúdo. Uma combinação de cores e decorações pode ser utilizada para anotar os campos. Essa página de preferências foi planejada para mostrar o que é possível ao configurar decorações. Ela está mais voltada ao programador que está testando o assistente de campo, e não foi planejada como exemplo de uma boa página de preferências para permitir que os usuários finais controlem as anotações.

A página Preferências do Assistente de Conteúdo permite configurar como o assistente de conteúdo é instalado no campo de texto do diálogo. A maioria das opções fornecidas na API (ContentProposalAdapter) do assistente de campo pode ser configurada nessa página. Observe que é possível configurar o assistente de conteúdo para uma experiência indesejável do usuário. Por exemplo, definir o assistente de conteúdo para ativação automática em todos os caracteres utilizando um longo retardo não é desejável. Pode ser confuso utilizar filtragem de propostas cumulativas quando as chaves de filtro não são propagadas de volta ao controle. O propósito de expor a API na página de preferências é permitir que o programador de assistente de campo tente todas as combinações possíveis. Não se espera que alguma dessas preferências já estaria exposta a um usuário final, mas antes que o desenvolvedor escolha a melhor combinação desses valores para fornecer um determinado estilo de assistente de conteúdo.

Utilizando o Diálogo

O diálogo de exemplo mostra diversos tipos de campos:

Código Fonte de Exemplo

O diálogo de exemplo não é muito complexo, mas foi planejado para demonstrar como programar o assistente de campo. Seguem algumas notas sobre o código fonte: