Combo Box

Kalipso - Developing - Form - Controls - Type - Combo Box

A Combo Box is a set of 3 Controls: Input Box, Button and List Box. In Kalipso, Combo Boxes are not editable. You can use Combo Boxes to show data as in an Input Box but with a Button that allows the user to see the rest of the data in an expandable List Box. A Combo Box can be loaded with data from the Database and/or with fixed Options. You can also link a Combo Box to the Database. A Combo Box can interact with the user through its Events.

Combo Boxes are useful to show a specific item of a bigger list and to filter data shown in other Controls. Value - Its value is the the Returned Value or the Returned Column.

For the control in question, when opening its properties, the following window appears:

Depending on the control chosen, the properties are different.

Properties

Tab - General

  • 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 - Not applicable to this 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.

Miscellaneous

  • Input Type - Type of Input Box

    • Alpha: The Combo Box will accept alphanumeric chars.

    • Numeric: The Combo Box will only accept numeric chars.

  • List Height - Height of the list

Style Appearance

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

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

  • Row Height - Row height

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 for the label 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 - Set a customized rectangle

    • Customized Circle - Set a customized circle

  • 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.

Advanced Style

  • Selected Text - Color of the selected text

  • Selected Row - Color of the selected row

  • Odd'Row - Color of the odd rows that are not selected

  • Even Rows - Color of the even rows that are not selected

  • Multiline - Check box to make each row a multiline text row

Image

  • Arrow Button - You can choose the type of arrow standard or customized. When choosing the custom type, the system prompts you to insert the arrow image, opening a new area below.

  • Arrow Position - When choosing the custom arrow type, the system allows the position of the arrow to be defined, opening a new window.

Tab - Content

Fill Local Control with:

  • None - If select it will use the Kalipso database if filled.

  • Database Table - You can use data of one of the database you have imported

  • SQL Advanced - You can use SQL Advance to fill the combobox.

Predefined Options

  • No - It does not define initial options.

  • At Beginning - At the beginning of the list

  • At End - At the end of the list

Table

  • Displayed Value - Value that appears as an option

  • Returned Value - Relation of the value that appears as an option with the field in the database.

You can remove or load more options by clicking the buttons on the right in the table.

When clicking on the load options option, a pop-up window appears with the following possibilities for filling. These options allow the inclusion of default settings in the combo box, such as printers and terminal communication types.

  • Printer Type

  • Printer Communication Type

    • IRDA

    • Cable

    • Bluetooth

    • TCP/IP

    • Bluetooth Socket

  • Baud Rate for

    • Printer

    • Serial Port

  • Data Bits

  • Stop Bits

  • Parity

  • Connection Manager

  • Project Languages

Links can be associated with this control. For this, the source must be indicated for them. These can be loaded in two types: database and expression.

  • Source - Origin of the data to show in the Input Box

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

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

When choosing database the options are:

There are two ways of connecting your Input Box to a Database 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>

- When choosing expression the options are:

A new field is active to be filled in where you are asked to fill in the controlog with the result of ...

  • 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.‌‌

In order to save and use this control, you must, in the content tab, establish the source of the data. If not, Kalipso will not allow you to save.

Shortcuts‌

  • F2 - Actions

  • F3 - General Properties

Last updated