This section describes how to create and save a new form, place elements on a form, and access and modify element properties.

Creating a New Form

1. You can create a new form using one of three methods:

Note: You must be in an active solution to create a new form.

The New Form window will appear:

2. Enter the following information:

3. Click on the Next button to add dataproviders to the form if you wish (you can also add these later using the Form Editor as you develop the form). Multiple dataproviders can be selected by holding down the CTRL key.

4. Select your desired options to set on the selected dataproviders:

5. Click Finish. A new Form Editor is opened for the newly created Form.

Saving a Form

The new form is saved with the preselected dataprovider fields upon creation. When you make changes to the form, an asterisk next to the form's name at the top of the Form Editor indicates that there are unsaved changes. You can save the form by:

To revert unwanted changes, use the context menu on the form and select Revert Form (at the top of the list).

Grouping Forms

Sometimes a solution contains large numbers of forms, and the need to group them in a logical manner becomes obvious. In order to group the forms from within a solution, working sets are used.

Working sets are acting like 'folders' in which forms are added to provide a better structure of the whole set of forms contained by a solution.

A working set can be added by right clicking on the Forms node from under the active solution, and choosing Add working set. A new working set can be created or an existing working set can be chosen from the list of existing working sets, to which the project will be added.

When a working set is added, it will be shown under the Forms node, and forms will be able to be dragged and dropped in and out of it.

Note that all working sets are stored in the resources project, which allows them to be shared between developers through the team provider used.

Placing Elements on a Form

You can place elements on a form using several different ways:

The following elements are available:

Note: A text field can be linked to a datasource (once placed, the datasource can be assigned by double-clicking the element, or by selecting the field and then clicking on the Text Field icon in the Elements toolbar.)

Setting Properties for Each Element

The Properties view allows you to set some formatting properties for each element. Examples include size, background, border type, fonts, and margins. More details can be found in the Developer Reference section.

The Properties view loads by default when you open Servoy. If it has been minimized, it can be re-loaded by clicking on the menu item Window > Show View > Properties.

The next section describes the layout tools available in Servoy 6.