Check Box

Kalipso - Developing - Form - Controls - Type - Check Box

A Check Box is a frame with 2 statuses: check or unchecked. A Check Box can have a text. You can also link a Check Box to the Database. A Check Box can interact with the user through its Events. You should use a Check Box to display true/false options or fields. Value - Its value is either 1 (checked) or 0 (unchecked).

Properties

Tab - General

Common

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

  • Text - Text to be displayed in the Control

  • Description - Not applicable to this control.

  • Plane - Plane of the Form where the Control should be created. Check the Planes chapter for more information.

  • Visible - With this option selected, the control is (or is not) visible.

  • Enabled - With this option selected, the control is (or is not) enabled. It may be visible (previous option), but it may not be enabled. In this case an event associated with the control is not executed.

Layout

  • X - x position of the Control from left

  • Y - y position of the Control from top

  • Width - Width of the Control.

  • Height - Height of the Control

In relation to all these layout options, it is possible to set this value in runtime via the “Set Property” Action. You can also retrieve this value in runtime via the “Get Property” Action.

Style

Appearance

  • Type -

    • Check-box - The checkbox is a button used to allow a user to make multiple choices which is broadly used in forms and surveys. Checkboxes are used to select one or several options in a list, for example.

    • Toggle Button - A toggle button allows the user to change a setting between two states. In this case: on or off.

    • Switch Button - A Switch Button is used for activating one of two predefined options. Commonly used as an on/off button but in this case having a different graphic appearance than the previous button (Toggle Button). You can also link a Switch Button to the Database. A Switch Button can interact with the user through its Events. You can use a Switch Button to display true/false options or fields.

  • Background - Background color of the Control. You can set the color for the background.

  • Opacity - Set the percentage of opacity for the background.

When choosing a type of checkbox button, the previous options change in the window to respond to the characteristics of that type of button selected.

You can set this value is runtime via the “Set Property” Action. You can retrieve this value in runtime via the “Get Property” Action.

On the right side of the Style section, you can choose templates with pre-defined styles or configurable ones. By clicking on this option, the following style possibilities appear:

  • Styles

    • None

    • Base

Text

  • Font – Font of the displayed Text

  • Size – Font size of the displayed Text

  • Font Color – Font color of the displayed Text and/or select the code in the color picker.

  • Font properties - Set of options where you can choose whether the font is bold, italic or underline

  • Text alignment - You can choose alignment to the left, center or right.

Border

  • Border – To set or remove the frame around the Control. When choosing this option, the application allows the following types of border:

    • No – No border is displayed

    • Default - A frame is displayed around the Control

    • Customized Rectangle - As its name indicates

    • Customized Circle - As its name indicates

  • Line - Set the color of the line or select the code in the color picker.

  • Thickness - Thickness of the frame to be drawn around the Control

  • Rounded Corners - Allows to specify how the corners of the frame drawn around the Control should be drawn.

    • No - The corners of the frame drawn around the Control will be 90 degrees (rectangle)

    • Rounded Tops - Instead of drawing each corner, a semicircle is drawn in each top (left and right)

    • Specify Radius - Allows you to specify the radius of the semicircle to be draw in each corner of the Control

  • Radius - Radius of the semicircle to be draw in each corner of the Control

  • Borders - Choose which line of borders you want to add (left, right, top, bottom, all around).

You can activate or deactivate the Border through “Set Property” Action. You can know if it's active or not in runtime via the “Get Property” Action.

Image

  • Icon - In this option you can choose to use the basic Kalipso icon (or the chosen design) for the check box or choose your own image to associate with the control. The system allows two options:

    • Standard - Use of the system icon

    • Costumized - When selecting the custom option below, two areas appear where you can associate images for control at the level of what appears for the checked or unchecked. To use it, just click on the search symbol to associate the image you want to insert.

  • Icon position - Having the custom option selected then this option allows you to choose whether the alignment is right, left or customized. When choosing the last option, a new window opens to configure the specific positioning.

Source – Origin of the data to show in the control

  • Nothing - Empty Input Box (depends on the “Input Type” property).

  • Database Table - Connect the Input Box with a Column of a Database Table.

  • Expression: Fill the Input Box with the result of an Expression.

After choosing the source of the data, you will need to fill in a data set in the fields below. Thus:

Database Table

There are two ways of connecting your Input Box to a Database Table therefore presenting the value of a specific Column.

  • 1 – You can do it by simply defining the "Table" and "Column" properties and then using the "First Record"/"Last Record"/"Next Record"/"Previous Record" and "Refresh"/"Refresh Plane"/"Refresh Control" Actions.

  • 2 – The other way is to implicitly define a "Select" statement. To do so, you have to define the "Table", "Column", "Where the value of" and "It’s equal to" properties then use the Refresh", "Refresh Plane" or "Refresh Control" Action. This way you are telling Kalipso to perform a "Select" statement like this:

Select <Column> from <Table> where <Where the value of> = <It’s equal to>

Target (store the control's Value in) If this property is set, when Kalipso tries to use the value of this Input Box for executing one of the above Actions, it checks if the value is non empty; if it’s not, Kalipso will produce an automatic error message.

  • Global Variable – Global Variable where to store the Input Box value;

  • Local Variable – Local Variable where to store the Input Box value;

  • Database

    • Table – Table where to store the Input Box value;

    • Column – Column where to store the Input Box value;

Tab - Actions

For each control, actions can be associated. For this, with the control selected, it is possible to access this tab and associate an action to the control. For more information on the actions available and how to use them click here.‌

Shortcuts

  • F2 - Actions

  • F3 - General Properties

Last updated