Formulário é um controlo básico utilizado para albergar Formulários de UI. Permite a definição de um título e o deslocamento do conteúdo semelhante a um browser da Web. O que torna os formulários atractivos é o facto de o conteúdo ser um compósito de SWT que pode ser usado da mesma forma que em outros contextos. Por exemplo, considere a seguinte porção de código:
public class FormView extends ViewPart { private FormToolkit toolkit; private ScrolledForm form; /** * The constructor. */ public FormView() { } /** * This is a callback that will allow us to create the viewer and * initialize it. */ public void createPartControl(Composite parent) { toolkit = new FormToolkit(parent.getDisplay()); form = toolkit.createScrolledForm(parent); form.setText("Hello, Eclipse Forms"); } /** * Passing the focus request to the form. */ public void setFocus() { form.setFocus(); } /** * Disposes the toolkit */ public void dispose() { toolkit.dispose(); super.dispose(); } }
Os Formulários de UI manipulam widgets de SWT de várias formas para concretizar o efeito pretendido. Por esse motivo, os controlos são criados geralmente com o
FormToolkit
. Regra geral, cria-se uma instância de ScrolledForm
para obter deslocamento. Quando é preciso imbricar formulários, uma instância Form
proporciona tudo salvo o deslocamento do conteúdo do formulário.
O conteúdo do formulário é apresentado abaixo do título. Os widgets de SWT são criados no formulário através de Form.getBody()
como ascendente.