COMBO-BOX widget

A combo box is a field‑level widget that combines the functionality of a fill‑in field, radio set, and selection list into one fill‑in and drop down list. You can set up a static combo box widget with the VIEW-AS phrase. You can create a dynamic combo box with the CREATE widget statement. The following figure shows a combo box:

Attributes

 

AUTO-COMPLETION attribute1	AUTO-RESIZE attribute	AUTO-ZAP attribute1
BGCOLOR attribute1	COLUMN attribute	CONTEXT-HELP-ID attribute
CURSOR-OFFSET attribute1	DATA-TYPE attribute	DBNAME attribute
DCOLOR attribute1	DELIMITER attribute1	DISABLE-AUTO-ZAP attribute
DROP-TARGET attribute	DYNAMIC attribute	EDIT-CAN-PASTE attribute1
EDIT-CAN-UNDO attribute1	FGCOLOR attribute1	FONT attribute1
FORMAT attribute1	FRAME attribute	FRAME-COL attribute
FRAME-NAME attribute	FRAME-ROW attribute	FRAME-X attribute
FRAME-Y attribute	HANDLE attribute1	HEIGHT-CHARS attribute1
HEIGHT-PIXELS attribute1	HELP attribute	HIDDEN attribute
HWND attribute	INDEX attribute	INNER-LINES attribute1
INPUT-VALUE attribute1	INSTANTIATING-PROCEDURE attribute	LABEL attribute
LABELS attribute	LIST-ITEM-PAIRS attribute1	LIST-ITEMS attribute1
MANUAL-HIGHLIGHT attribute	MAX-CHARS attribute1	MENU-KEY attribute
MENU-MOUSE attribute	MODIFIED attribute	MOUSE-POINTER attribute
MOVABLE attribute	NAME attribute1	NEXT-SIBLING attribute
NEXT-TAB-ITEM attribute	NUM-DROPPED-FILES attribute	NUM-ITEMS attribute1
PARENT attribute	PFCOLOR attribute1	POPUP-MENU attribute
PREV-SIBLING attribute	PREV-TAB-ITEM attribute	PRIVATE-DATA attribute
RESIZABLE attribute	ROW attribute1	SCREEN-VALUE attribute1
SELECTABLE attribute	SELECTED attribute	SELECTION-END attribute
SELECTION-START attribute	SELECTION-TEXT attribute	SENSITIVE attribute
SIDE-LABEL-HANDLE attribute	SORT attribute1	SUBTYPE attribute1
TABLE attribute	TAB-POSITION attribute	TAB-STOP attribute
TEXT-SELECTED attribute	TOOLTIP attribute	TYPE attribute1
UNIQUE-MATCH attribute1	VISIBLE attribute	WIDGET-ID attribute
WIDTH-CHARS attribute1	WIDTH-PIXELS attribute1	WINDOW attribute
X attribute1	Y attribute1	–

---

1

This attribute also applies to combo-box browse columns.

Methods

 

ADD-FIRST( ) method1	ADD-LAST( ) method1
CLEAR-SELECTION( ) method1	DELETE( ) method1
EDIT-CLEAR( ) method1	EDIT-COPY( ) method1
EDIT-CUT( ) method1	EDIT-PASTE( ) method1
EDIT-UNDO( ) method1	END-FILE-DROP( ) method
ENTRY( ) method1	GET-DROPPED-FILE( ) method
INSERT( ) method1	LOAD-MOUSE-POINTER( ) method
LOOKUP( ) method1	MOVE-AFTER-TAB-ITEM( ) method
MOVE-BEFORE-TAB-ITEM( ) method	MOVE-TO-BOTTOM( ) method
MOVE-TO-TOP( ) method	REPLACE( ) method1
SET-SELECTION( ) method1	VALIDATE( ) method

---

1

This method also applies to combo-box browse columns.

Events

 

Default keyboard events	Developer events
Field editing key function events	General direct manipulation events
Mouse events	Navigation key function events
Universal key function events	DROP-FILE-NOTIFY ,
ENTRY	LEAVE
VALUE-CHANGED	–

See also 

CREATE widget statement, VIEW-AS phrase