The functionality described here does not embrace all the functionality provided by Lycia 3.

If you use Lycia 3, please, turn to other sections of this online documentation.

You are here:

Combo box field

$Description: C:\Users\user\Desktop\combo.png$

A combo box field displays itself as a field with a down arrow button at the right hand end. Clicking the down arrow displays a drop down list of values from which users can choose. The list can be populated statically within the form definition using the ‘include’ attribute. There is also the option to allow the user to enter data into the field which do not exist in the list. At runtime, the combo list values can be changed (removed, inserted, searched, etc…) by using the relevant fgl_list_xxx() functions. The user can select list entries either by using the mouse or by navigating through the list using the keyboard (cursor keys or alpha numerical keys to search for entries).

Attributes Syntax:

<tag> = <field>,

widget="combo",

class="combo", (Optional)

include=(list item 1, list item2, list item n);

This code sample creates a combo box field containing all the days of the week. With the class set to ‘combo’ the user will also be able to enter their own data into the field.

ATTRIBUTES

f_combo=formonly.f_combo,

widget="combo",

class="combo",

include=("Monday",

"Tuesday",

"Wednesday",

"Thursday",

"Friday",

"Saturday",

"Sunday");

Properties

Combo List Boxes require setting the widget attribute to ‘combo’. The list is produced with the include property which is a comma separated list. The class property (class = "combo") is optional and is used to allow the user to enter data (freely) which are not in the include list. In this case, the server will no longer validate the field data with the include list.

widget

The name of the combo list field widget is ‘combo’

widget = "combo"

class

For ‘selection only’ combo list boxes you do not need to specify this attribute. If the user should be allowed to select from the list AND enter data freely into the field, set the class to combo.

class="combo"

include

The include property (just like for any other 4GL field) is used to define a list of valid entries. In a graphical environment, these items are displayed in the combo list.

include = ("Mr.","Mrs.","Dr.")

For formonly fields, always specify the data TYPE property for the field; otherwise a conversion error type may occur from the combo list data type to the field data.

When clicking on any item within the list, the value in the field is changed, however any AFTER FIELD logic associated with the field will not be triggered unless the user attempts to leave the field either by pressing ‘tab’ or by selecting another field with the mouse.

$Description: C:\Users\user\Desktop\FormsScreenShots\c_box1.jpg$

How to Create a Combo List Box - Example

Project: forms
Program: fm_field_widget_combo1 …~2 , …~simple and …~event

.per form:

DATABASE formonly

SCREEN

{

Simple\g \gCombo\g \gBox\g \gDemo\g \gApplication

[f_combo ]

}

ATTRIBUTES

f_combo=formonly.f_combo,

widget="combo",

include=("Monday",

"Tuesday",

"Wednesday",

"Thursday",

"Friday",

"Saturday",

"Sunday");

INSTRUCTIONS

DELIMITERS "[]"

$Description: C:\Users\user\Desktop\FormsScreenShots\c_box2.jpg$

Normal fields which have an INCLUDE attribute will by default be rendered as a combo box. This behavior can be turned off using the script resource nocombo.