True DBList Pro Objects and Collections

True DBList provides a rich set of properties, methods, and events that enable you to develop sophisticated database applications. The organization imposed by True DBList's object model makes it easier to work with such a large feature set.

Objects and collections that refer to visual entities, such as columns, can be customized at design time or run time. Objects and collections that refer to abstract entities, such as arrays and bookmarks, are only available in code at run time.

When you add True DBList to a Visual Basic project, the following controls are added to the toolbox:

TDBList	True DBList ActiveX control.
TDBCombo	True DBCombo ActiveX control.

The type library for True DBList also contains definitions for the following objects:

Column	Represents a column of data within a list or split.
DataObject	Transfers data between OLE drag sources and drop targets.
PrintInfo	Encapsulates page setup and print job settings.
RowBuffer	Transfers data to and from row-based unbound mode events.
Split	Represents a group of adjacent columns that scroll as a unit.
Style	Encapsulates font, color, picture, and formatting information.
ValueItem	Allowable input value for a column, with optional translation.

A collection is an object used to group similar data items, such as bookmarks, or visual objects, such as list columns. In general, a group of similar items in True DBList is implemented as a collection. Since a collection is an object, you can manipulate it in code just as you would any other object. The type library for True DBList contains definitions for the following collections:

Columns	Contains zero or more Column objects in a list or split.
GroupColumns	Contains zero or more Column objects in the grouping area.
Layouts	Contains zero or more named list layouts.
PrintInfos	Contains one or more PrintInfo objects in a list.
SelBookmarks	Contains zero or more selected row bookmarks.
Splits	Contains one or more Split objects in a list.
Styles	Contains built-in and user-defined Style objects for a list.
ValueItems	Contains zero or more ValueItem objects for a column.

When using True DBList's storage mode (DataMode 4), you also need to add a reference to the ComponentOne XArrayDB Object to your project. This is not a control, but a reference that defines a single nongraphical object:

XArrayDB

Variant array used as a data source in storage mode.

The following sections provide a brief overview of True DBList's objects and collections.