Vcl.DBCtrls.TDBLookupControl.ListField

From RAD Studio API Documentation
Jump to: navigation, search

Delphi

property ListField: string read FListFieldName write SetListFieldName;

C++

__property System::UnicodeString ListField = {read=FListFieldName, write=SetListFieldName};

Properties

Type Visibility Source Unit Parent
property protected
Vcl.DBCtrls.pas
Vcl.DBCtrls.hpp
Vcl.DBCtrls TDBLookupControl

Description

Identifies the field or fields whose values are displayed in the lookup control.

The lookup control represents a field in one table by displaying the value of one or more corresponding fields in another table. ListField is the name of the field or fields in the lookup table that are actually displayed, as opposed to the DataField, which is the field in the DataSource that the lookup control actually represents, or the KeyField, which is the field in the lookup table with the same value as the DataField.

To fully specify the list fields, both a dataset for the lookup table and the fields within that dataset must be defined. The ListSource property of the lookup control specifies the dataset for the lookup table.

ListField can represent more than one field. Separate multiple field names with semicolons.

Before specifying ListField, specify the link between the two datasets using the KeyField property. If ListField is not set, lookup controls display KeyField field values by default. If the DataField field is a lookup field, don't specify anything for ListField; the data controls automatically use the lookup field's LookupResultField property as ListField.

See Also