Rapid-Q Documentation by William Yu (c)1999-2000 | Appendix A: QCOMBOBOX

# QCOMBOBOX Component

  QCombobox implements a simple pull down listbox. The first item in any combobox is 0, the next is 1, and so on...
  QCombobox Properties

  Field | Type | R/W | Default | Support

  Align | INTEGER | RW | alNone | W
  | Align determines how the control aligns within its parent control.
  Color | INTEGER | RW |  | W
  CopyMode | INTEGER | RW | cmBlackness | W
  Cursor | INTEGER | RW | crDefault | W
  DropDownCount | INTEGER | RW | 8 | W
  | DropDownCount is the maximum number of items displayed in the drop-down list.
  Enabled | INTEGER | RW | True | WXG
  Font | QFONT | W |  | W
  Height | INTEGER | RW |  | WXG
  Hint | STRING | RW |  | WXG
  Item | ARRAY of STRING | RW |  | WXG
  ItemCount | INTEGER | R |  | WXG
  ItemHeight | INTEGER | RW |  | W
  ItemIndex | INTEGER | RW | -1 | WXG
  | ItemIndex indicates which item in the drop-down list is selected. If no item is selected, then ItemIndex is -1.
  Left | INTEGER | RW | 0 | WXG
  MaxLength | INTEGER | RW |  | W
  | MaxLength is the maximum number of characters the user can type into the edit portion of the combobox.
  Parent | QFORM/QPANEL/QTABCONTROL | W |  | WXG
  PopupMenu | QPOPUPMENU | W |  | W
  ShowHint | INTEGER | RW | False | WXG
  Sorted | INTEGER | RW | False | WG
  Style | INTEGER | RW | csDropDown | W
  | Style determines the display style of the combobox. 0 = csDropDown -- A drop-down list with an edit box for manually entered text. 1 = csSimple -- A drop-down list with an edit box and a fixed list (list box) underneath. 2 = csDropDownList -- A drop-down list with no edit box for manual entry.
  3 = csOwnerDrawFixed -- Owner-draw drop-down list with an edit box. Each item in the list is the height specified by the ItemHeight property.
  4 = csOwnerDrawVariable -- Owner-draw drop-down list with an edit box. Each item can have varying heights.
  TabOrder | INTEGER | RW |  | W
  Tag | INTEGER | RW |  | WXG
  Text | STRING | RW |  | W
  Top | INTEGER | RW | 0 | WXG
  Visible | INTEGER | RW | True | WXG
  Width | INTEGER | RW |  | WXG

  QCombobox Methods

  Method | Type | Description | Params | Support

  AddItems | SUBI | Add items to combobox | STRINGs, Infinite | WXG
  Circle | SUB (x1%, y1%, x2%, y2%, c%, fill%) | Draw & Fill Circle | 6 | W
  Clear | SUB | Clears entire Combobox | 0 | WXG
  CopyRect | SUB (D, Image, S) | D and S are QRECTs, Image can be a QImage, QCanvas, or QBitmap | 3 | W
  DelItems | SUBI | Delete items by their index | Index #s, Infinite | WXG
  Draw | SUB (x%, y%, BMP) | Draw Bitmap at (X,Y) | 3 | W
  FillRect | SUB (x1%, y1%, x2%, y2%, c%) | Draws & Fills a rectangle | 5 | W
  InsertItem | SUB (Index%, String$) | Insert item at Index% | 2 | WXG
  Line | SUB (x1%, y1%, x2%, y2%, c%) | Draws a line | 5 | W
  Paint | SUB (x%, y%, c%, borderc%) | Fill Region | 4 | W
  Pset | SUB (x%, y%, c%) | Pixel plot | 3 | W
  Rectangle | SUB (x1%, y1%, x2%, y2%, c%) | Draws a rectangle | 5 | W
  Repaint | SUB | Force repainting of combobox | 0 | W
  RoundRect | SUB (x1%, y1%, x2%, y2%, x3%, y3%, c%) | Draws & Fills a rounded rectangle | 7 | W
  StretchDraw | SUB (Rect AS QRECT, BMP) | Draw BMP and stretch to fit inside Rect | 2 | W
  TextHeight | FUNCTION (Text$) AS WORD | Returns the height, in pixels, of Text$ string | 1 | W
  TextWidth | FUNCTION (Text$) AS WORD | Returns the width, in pixels, of Text$ string | 1 | W
  TextRect | SUB (Rect AS QRECT, x%, y%, S$, fc%, bc%) | Write text, and clip within region Rect | 6 | W
  TextOut | SUB (x%, y%, S$, fc%, bc%) | Writes text to image | 5 | W

  QCombobox Events

  Event | Type | Occurs when... | Params | Support

  OnChange | VOID | User selects a different item | 0 | WXG
  OnDrawItem | SUB (Index%, State%, R AS QRect) | Items are redrawn for ownerdraw comboboxes | 3 | W
  OnMeasureItem | SUB (Index%, Height%) | Calculate Height for ownerdraw variable comboboxes | 3 | W

  QCombobox Examples

        DIM Form AS QForm
        DIM ComboBox AS QComboBox

        SUB ItemChanged
          PRINT ComboBox.Item(ItemIndex)
        END SUB

        ComboBox.Parent = Form
        ComboBox.OnChange = ItemChanged
        ComboBox.AddItems "1. Apples", "2. Oranges", "3. Bananas"

        Form.ShowModal

  Prev Component | Contents | Next Component