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
Tab - Link
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