Top
PowerCOBOL V11.0 Reference
FUJITSU Software

3.5 ComboBox Control

Description:

A ComboBox combines a text box with a list box. Text can be entered in the text box part or selected from the list box part.

There are three styles of ComboBoxes:

Simple

DropDown

DropDownList

Sample images:

Simple style:

A text box with a list box.

List always visible.

DropDown style:

(1)

(2)

A text box with a drop-down list box.

List only visible when drop down button pressed.

Text can be entered that is not contained in the list.

Control when list not selected.

Control with drop down list selected and arbitrary text entered.

DropDownList style:

(1)

(2)

A read-only text box with a drop-down list box.

List only visible when drop down button pressed.

Values in text box limited to values in the list.

Control when list not selected.

Control with drop down list selected.

Details:

File formats:

Data for the lists can be loaded from text files, CSV (Comma Separated Values) files, and fixed text format files.

Text files - As created with text editors like Notepad. Records are separated by carriage return, line feed bytes.

CSV files - Text files with fields separated by commas.

Fixed Length format files - Files with fixed length records not separated by any special characters.

Fields:

CSV and Fixed Length formats allow you to select a particular field from the records to display in the list. Define the fields for Fixed Text format files using the RecordForm property.

Only one field can be displayed at a time. Specify the field to be displayed using the CurFieldNo property.

Records:

For Simple and DropDown styles you can access the whole of the record, whose field value is selected in the list box part.

Filtered list:

For Simple and DropDown styles the values in the list box can be limited to match the characters in the text box part. When the IsQuery property is set to True, the list box part only displays items that start with the characters entered in the text box part.

When users want to display all the items in the list (i.e. clear the filter), they should delete all the text in the text box part and press the ENTER key.

Properties:

Array

AutoLoadFile

AutoSize

BackColor

ClassMajorVersion

ClassMinorVersion

ClassProgID

Container

CurFieldNo

Enabled

FileName

FileType

Font

ForeColor

Height

Highlight

HighlightColor

IMEMode

Index

IsQuery

Left

ListCount

ListIndex

ListString

Name

Parent

Printable

QueryString

RecordForm

RenderText

ScaleMode

ScalingStyle

SelField

SelString

Sorted

Style

TabGroup

TabIndex

TabStop

Text

ToolTipText

Top

Visible

Width

Methods:

AddString

ClearList

DeleteString

InsertString

LoadFile

Move

Refresh

SaveFile

SetFocus

ZOrder

Events:

Change

Click

DblClick

Edit

GotFocus

KeyDown

KeyPress

KeyUp

LostFocus

MouseDown

MouseMove

MouseUp

Return

SelChange

Class ProgID name:

Fujitsu.PcobComboBox.4

Corresponding Controls in PowerCOBOL V3.0 or earlier:

Combo Box Item

Selection Box Item