General

Kalipso - Developing - Form - Form properties - General

When creating a new form, a window for configuring the form's properties appears. By default, the general tab appears first.

Common

• Name - Name of the Form. This Name will be used to identify the Form throughout the Project. The name of the Form should only contain letters, digits or underscore (_).

• Title - Title of the Form. This Title will be displayed at the title bar of the Form.

• Description - Description of the Form. This Description is for your information only, Kalipso does nothing with it.

• Visible - Set the Form visible or invisible. You can set this property in runtime via the “Set Property” Action.

• First Form - Set the Form as the first one to be open. The First Form is the only one that can contain the “System Tray Click” Event. The other Forms will have the Event disabled.

Layout

• Size - Displays the size for the form. It can be one of the following:

  • Maximized - The Form will be maximized. A title bar will be displayed. If you deploy your Project to a Terminal with different screen size, the Form will assume the new dimensions and will be maximized.

  • Custom - To define a custom size. The dimensions cannot exceed the ones of the terminal screen.

• Width - Width of the Form. Only editable if “Size” property is set to “Custom”.

• Height - Height of the Form. Only editable if “Size” property is set to “Custom”.

You can set the value for Width and Height in runtime via the “Set Property” Action. You can retrieve the value in runtime via the “Get Property” Action.

• Position - Position mode of the Form. It can be one of the following:

  • Screen Centered - The Form will be centered in the screen.

  • Custom - To define a custom position.

• X - X position of the Form. Only editable if the “Position” property is set to "Custom".

• Y - Y position of the Form. Only editable if the “Position” property is set to "Custom".

You can set the value for X and Y in runtime via the “Set Property” Action. You can retrieve the value in runtime via the “Get Property” Action.

• Orientations - Definition of the orientation for the form. This can be inherited from the project definitions or customized. For this you can choose from:

  • Project Defined - Use project definitions for the form.

  • Custom - Defines an orientation (or set of orientations) for the form. To do this, simply choose the orientation shown below. Possible orientations are:

    • Portrait

    • Landscape

    • Portrait Flipped

    • Landscape Flipped

• Trigger on click outside the Form - This event is triggered when the “X” button of the Form is clicked. Its function focuses on the possibility of closing the application, but you can run any code you need. If you do want the form to close, then call CloseForm(). On Win32 systems it is the “X” button on the top right corner of the Window, on Android it is when you press the “Back Button” next to the “Home”. In Windows 10 the button exists but cannot be controlled by applications, ie, Windows simply closes the application and so the event cannot be handled in Kalipso. On iOS this concept does not apply.

• More options - In this area you can choose which additional system elements can be added to the form. When the size chosen is "Maximized" then all options are available. When in the same option is chosen "Custom" only the "Title bar" becomes available. So the options are:

  • Title bar

  • System bar

  • Horizontal Scroll

  • Vertical Scroll

Miscellaneous

• Keyboard - Controls the visibility of the keyboard. it can be one of:

  • Project Defined

  • Prevent Automatic Display

  • Display Automatically

• Navigation Bar - Controls the visibility of the Navigation Bar. it can be one of:

  • Project Defined

  • Hide

  • Display

Style

Apperance

• Background - Background color of the Form. You can set this value is runtime via the “Set Property” Action.

In the color bar you can click on the icon on the left to open the color picker.

The color picker can be used in three ways: through standard colors, resources or color details. The standard colors are those shown, with the possibility of defining transparencies or accessing system colors. The resources base the colors on the theme chosen for the project and the color details option allows you to define colors using hexadecimal code, RGB, etc. You can choose one of three ways.

Image

• Mode - Mode of the background image. The choice hypotheses are:

  • 100% - The image will be displayed at 100% in the position defined by the “X” and “Y” properties.

  • Stretched - The image will be stretched (increased or decreased) in order to totally cover the Form.

  • Proportionally Stretched - The image will be proportionally (keeping its ratio) stretched (increased or decreased) until it fits totally in the Form.

  • Centered - The image will be centered in the Form. No resizing done. This option is the one that appears by default.

• X - X position of background image. Only editable if “Mode” is set to ‘100%’.

• Y - Y position of background image. Only editable if “Mode” is set to ‘100%’.

In the area below, the area for placing the image is available. Clicking opens a new window with access to the image resources.