Form

Kalipso - Developing - Form

A Form is a window that can contain other Controls (except other Forms). A Form can interact with the user through its Events. You must use this control in order to use the others.

To add a Form, select the “Form” button on the Controls Toolbar of Main Window.

The following image illustrates a blank form that appears when a new one is added to the design area.

In the same project you can have several forms that can also interact with each other.

In the form's example above, you can see that the grid is active in the form's workspace. To activate or deactivate this option (where you can also activate the snap to grid option) you can access the menu File > Settings and then on the right side are the specific options (general tab).

To work with forms are available a set of features that provide a range of solutions for the development project. The links below provide access to more features of these options.

• Controls

• Actions

• Expressions

• Functions

• Events

In addition to the indicated list, it provides also information on how to create profiles or use:

• Database Connection Profiles

• Communication Profiles

• Global Variables

New Form

With the project started and open, we can add more forms to it. Clicking on the icon to add a Form, the following window appears:

When the window appears, it is divided into two zones: for choosing a form template already defined (or even blank) and the possibility of associating services with this new form.

You can choose a template for your smartphone or tablet or even search for a template that you have already created. In the option "For Configuration", you can associate the form to create three options that are accessible later. Here are the links to their pages:

• Database Connection Profile

• Communication Profile

• Printer

For each template, several types of screens with the same graphic aspect are suggested. Despite this, it is always possible to change the suggested template.

Popup menus

When you right-click on a form in an area without controls or another element, the following popup menu appears:

The options are (with the keyboard shortcut indication):

• Insert - Insert a control showing the list of possible ones.

• Copy Form - Copy the selected form

• Paste Form - Paste a copied form

• Paste Control - Paste a copied control

• Rename Current Plane - Renames the selected Plane

• Properties - Access form properties

• Actions - Shortcut to the actions screen

• Duplicate - Duplicates the selected local action set. Copy and paste in one simple action.

• Set as First Form - Set the Form as the first one to be open

• Check Usage - This is a shortcut to the Find option. Indicates where the selected object is being used.

• Convert Portrait to Landscape - This applies only when the "Custom" option is active in the project properties "Orientation"> "Management". According to the default view defined, and after clicking on “rotate” (menu bar) converts portrait to landscape taking into account two option groups: duplicating or calculating the position of the elements in the form.

• Convert Landscape to Portrait - This applies only when the "Custom" option is active in the project properties "Orientation"> "Management". According to the default view defined, and after clicking on “rotate” (menu bar) converts landscape to portrait taking into account two option groups: duplicating or calculating the position of the elements in the form.

• Delete Form - Delete the selected form.

• Reset Local Vars, Timers and Planes - Resets everything in local variables, timers and planes that are in the form. You have two options: “Keep names” where you keep the names and “Full Reset” where you reset everything.

• Add as Template - Adds the form as a template in Kalipso.

When you right-click on a control on the form, the following popup appears:

• Copy - Copy the selected control.

• Paste - Pastes the selected control.

• Cut - Cuts the selected control.

• Lock - Lock the control position on the form.

• Group - Groups the selected controls in a single set.

• Delete - Deletes the selected control.

• Move to Plane... - Moves the selected control to a different plane than the active one among those available. Clicking opens a window for selecting the destination plane.

• Properties - Access control properties.

• Actions - Opens directly in the tab actions of the selected control properties.

• Check Usage - This is a shortcut to the Find option. Indicates where the selected object is being used.

• Edit Container Cell - This option is only active with the following controls: "Looper" "Scrool Area" and "Tab". Its aim is to open a larger specific area that facilitates the inclusion of other controls on the previously indicated. It is a facilitator for the insertion and management of objects.

• Send to Back - The ability to send a Control or a group of Control to the Background with a context menu, without having to go to the Set Focus screen

• Bring to Front - The ability to Bring a Control or a group of Control to the Foreground with a context menu, without having to go to the Set Focus screen.