[Overview][Constants][Types][Classes][Procedures and functions][Index] | Reference for unit 'DbCtrls' (#lcl)

# TDBListBox

[Properties (by Name)] [Methods (by Name)] [Events (by Name)]

TDBListBox - a data-aware version of TListBox, for displaying lists of entries from a field in a database

## Declaration

Source position: dbctrls.pp line 392

`type TDBListBox = class(TCustomDBListBox)`
`protected`
`procedure DataChange(); override;` |  | DataChange - method for dealing with a change in the data
`procedure UpdateData(); override;` |  | UpdateData - method for applying any pending changes to the data
`protected`
`class procedure WSRegisterClass; override;`
`public`
`property Items; [w]` |  | Items - the data that form the list in the box
`published`
`property Align;` |  | Used to align the control to the top, bottom, left or right of its client.
`property Anchors;` |  | The set of anchor definitions for this control
`property BorderSpacing;` |  | Determines the border spacing for this control
`property BorderStyle;` |  | BorderStyle - none, or single
`property DataField;` |  | The name of the DataField to which the listbox belongs
`property DataSource;` |  | The identity of the DataSource from which the lookup data will be fetched
`property DragCursor;` |  | DragCursor - the style of cursor to be used during the Drag process
`property DragMode;` |  | DragMode - whether manual or automatic
`property ExtendedSelect;` |  | ExtendedSelect - boolean. Whether extended selection is allowed. Default True
`property ItemHeight;` |  | ItemHeight - the height of the individual Items
`property MultiSelect;` |  | MultiSelect - allows more than one Item from the list to be selected at a time, by pressing the CTRL or SHIFT key while selecting
`property OnClick;` |  | Event Handler for mouse click
`property OnDblClick;` |  | Event Handle for mouse double-click
`property OnDragDrop;` |  | Event handler for the drop of a control onto this control.
`property OnDragOver;` |  | Event handler for the case when a control is dragged over another control
`property OnDrawItem;` |  | OnDrawItem - event handler for drawing an Item
`property OnEndDrag;` |  | Event handler for the end of a dragging process
`property OnEnter;` |  | OnEnter - event handler for when the mouse enters the control, and the control receives focus
`property OnExit;` |  | OnExit - event handler for when the mouse leaves the control and it loses focus
`property OnKeyPress;` |  | OnKeyPress - event controller for a key being pressed while the control has focus. To properly handle national chars use UTF8KeyPress instead.
`property OnKeyDown;` |  | OnKeyDown - event handler for instance when key is down while control has focus
`property OnKeyUp;` |  | OnKeyUp - event handler for instance when a key is up (not pressed) while the control has focus
`property OnMouseMove;` |  | Event handler for mouse movement within the current control
`property OnMouseDown;` |  | Event handler for when a mouse button is pressed down
`property OnMouseUp;` |  | Event handler for when the mouse button is released, ie "up"
`property OnResize;` |  | Event Handler for resize of control
`property OnStartDrag;` |  | Event handler for start of dragging operation
`property OnUTF8KeyPress;` |  | UTF8KeyPress - event controller for a key being pressed while the control has focus.
`property ParentShowHint;` |  | ParentShowHint - does the control adopt the same hinting behaviour as its parent? Default is true
`property ReadOnly;` |  | ReadOnly - if True, the data can only be read but not written or edited
`property ShowHint;` |  | Flag to determine: Is hint to be displayed for this control?
`property Sorted;` |  | Sorted - whether the selected Items in the list have been arranged in alphabetical order
`property Style;` |  | Style of List Box - normal, owner-draw fixed, or owner-draw variable
`property TabOrder;` |  | The place this control occupies in the list of tabs
`property TabStop;` |  | Is the control in the sequence of controls accessed by successive presses of the Tab key?
`property TopIndex;` |  | Topindex - the highest value of Index in this list
`property Visible;` |  | Visible - can the control be seen?
`end;`

## Inheritance

`TDBListBox` |  | TDBListBox - a data-aware version of TListBox, for displaying lists of entries from a field in a database
`TCustomDBListBox` |  | TCustomDBListBox - base class for TDBListBox, a data-aware listbox for presenting list information from a database
`TCustomListBox` |  | TCustomList Box : the base class for TListBox
`TWinControl`
`TControl`
`TLCLComponent` |  | TLCLComponent - base class for LCL components
`TComponent,IUnknown,IInterfaceComponentReference`
`TPersistent`
`TObject`

## See also

HowToUseDataAwareControls |  | HowToUseDataAwareControls - Hints for accessing databases

The latest version of this document can be found at lazarus-ccr.sourceforge.net .