Gambas Documentation - /comp/gb.qt4/combobox

# ComboBox (gb.qt4)

Implements a text box combined with a popup list box.

(The picture shows two comboboxes, the second being read-only).

This class inherits Control.
This class is
Creates a new ComboBox control.
creatable
.
This class acts like a
Returns a combo-box item from its index.
read-only
array.

Properties | Methods | Events
--- | --- | ---

Returns or sets the action string associated with the control.
Action
Returns or sets the background color used by the control.
Background
Returns or sets if the control has a border.
Border
Returns the number of elements in the popup list box.
Count
Returns the current selected item of the popup list box.
Current
Use this property for assigning a custom cursor to a control.
Cursor
Indicates that the control is in design mode.
Design
Returns or sets if a control accepts drops.
Drop
Indicates that the control is enabled.
Enabled
Returns or sets if a control will expand if included in a container that arranges its contents.
Expand
Returns or sets the font used to draw text in the control.
Font
Returns or sets the foreground color used by the control.
Foreground
A synonymous for the Height property.
H
Returns the internal X11 window handle of the control.
Handle
Returns whether the control has the focus.
HasFocus
Returns or sets the height of the control.
Height
Returns whether the mouse cursor is inside the control.
Hovered
A synonymous for the Handle property.
Id
Returns or sets if a control must be ignored when its parent arranges its children.
Ignore
Returns the index of the current selected item of the popup list box.
Index
Returns or sets the position of the left border of the control relative to its parent.
Left
Returns the length of the text in the text box.
Length
Returns or sets the popup list box contents from a string array.
List
Returns or sets the maximum permitted length of the text in the text box.
MaxLength
Returns or sets the appearence of the cursor when it points inside the control.
Mouse
Returns or sets the name of the control.
Name
Returns the next control having the same parent.
Next
Return or set if a control cannot be focused with the TAB key.
NoTabFocus
Returns the control container.
Parent
Indicates if characters typed in the text box should be hidden and replaced by stars.
Password
Return or set the name of the menu that will be popped-up when the user presses the right mouse button or the keyboard `MENU` key.
PopupMenu
Returns or sets the position of the cursor in the text box.
Pos
Returns the previous control having the same parent.
Previous
Return or set the "proxy" of a control.
Proxy
Indicates if the combo-box is read-only, i.e. if its text box is editable or not.
ReadOnly
Returns the position of the left border of the control in screen coordinates.
ScreenX
Returns the position of the top border of the control in screen coordinates.
ScreenY
Returns if some text is selected in the ComboBox.
Selected
Returns an object used for managing the selected text.
Selection
Indicates if the popup list-box elements are sorted or not.
Sorted
Returns or sets the control tag.
Tag
Returns or sets the text of the text box.
Text
Returns or sets the tooltip shown when the mouse stays on the control a few time.
Tooltip
Returns or sets the position of the top border of the control relative to its parent.
Top
Returns or sets if the control will receive MouseMove events.
Tracking
Indicates if the control is visible or not.
Visible
A synonymous for the Width property.
W
Returns or sets the width of the control.
Width
Returns the top-level window that contains the control.
Window
Returns or sets the position of the left border of the control relative to its parent.
X
Returns or sets the position of the top border of the control relative to its parent.
Y

Inserts an element in the popup list box.
Add
Clears the combo box.
Clear
Destroys the control.
Delete
Starts a drag & drop process.
Drag
Finds an element in the poup list box and returns its index, or `-1` if the element cannot be found.
Find
Grab the keyboard and the mouse so that all keyboard and mouse events are received by the control.
Grab
Hides the control.
Hide
Inserts a string in the text box.
Insert
Sends the control to the background of its parent.
Lower
Moves and/or resizes the control.
Move
Moves and/or resizes the control.
MoveScaled
Opens the ComboBox popup menu.
Popup
Sends the control to the foreground of its parent.
Raise
Redraws the control, or just a part of it.
Refresh
Removes a element from the popup list box.
Remove
Changes the container of a control.
Reparent
Resizes the control.
Resize
Resizes the control.
ResizeScaled
Define the selected text.
Select
SelectAll
Gives the focus to the control.
SetFocus
Shows the control.
Show
Unselects the selected text of the ComboBox.
Unselect

Raised when the RETURN key is hit in the text box.
Activate
Raised when the text in the combo box is modified.
Change
Raised when an element is selected in the popup list box.
Click
Raised when the user quickly clicks twice on the control.
DblClick
This event is raised when the mouse enters the control during a drag & drop process.
Drag
This event is raised when the mouse leaves the control during a drag & drop operation.
DragLeave
This event is raised while the mouse moves inside the control during a drag & drop process.
DragMove
This event is raised when a drag is dropped in the control.
Drop
Raised when the mouse enters the control.
Enter
Raised when the control has got the focus.
GotFocus
Raised when a key is pressed while the control has the focus.
KeyPress
Raised when a key is released while the control has the focus.
KeyRelease
Raised when the mouse leaves the control.
Leave
Raised when the control has lost the focus.
LostFocus
Raised when the user clicks on the control with the right mouse button, or if it hits the `MENU` key.
Menu
Raised when a mouse button is pressed while the cursor is inside the control.
MouseDown
This event is raised when a drag operation should be started.
MouseDrag
Raised when the mouse moves inside the control while a mouse button is pressed.
MouseMove
Raised when a mouse button is depressed while the cursor is inside the control.
MouseUp
This event is raised when the user moves or presses the mouse wheel while the mouse is inside the control.
MouseWheel