TRxLookupEdit Component

Unit
RxLookup

Description
Компонента TRxLookupEdit представляет собой редактор с возможностью как прямого ввода текста пользователем в строке редактирования, так и выбора текста из выпадающего списка, заполняемого значениями из базы данных. При открытом списке или при значении свойства PopupOnlyLocate=False набор пользователем символов с клавиатуры приводит к позиционированию списка на ближайшую запись, совпадающую с введенным текстом.

Для заполнения выпадающего списка используются свойства LookupSource, LookupField, LookupDisplay и LookupDisplayIndex, аналогично списку компоненты TRxDBLookupCombo.
Введенное пользователем или выбранное из списка значение доступно через свойство Text.
Свойство LookupValue (read-only) позволяет получить значение ключевого поля из lookup-набора данных (заданного свойством LookupField), если пользвателем был сделан выбор из списка.


Примеры работы и некоторые интересные свойства и методы.

Applies to
TRxLookupEdit component

Declaration
property PopupOnlyLocate: Boolean;

Description
Свойство определяет, будет ли производится поиск вводимого пользователем значения в lookup-наборе данных при закрытом выпадающем списке. По умолчанию имеет значение True, и поиск производится только при открытом списке.



Applies to
TRxLookupEdit, TRxDBLookupList, TRxDBLookupCombo components

Declaration
property LookupDisplayIndex: Integer;

Description
В случае, если свойство LookupDisplay задает более одного поля для отображения в списке, значение свойства LookupDisplayIndex определяет номер поля, значение которого возвращается свойством DisplayValue и отображается в строке компоненты TrxDBLookupCombo.


Applies to
TRxLookupEdit component

Declaration
property LookupValue: string;

Description
Run-time only. Свойство позволяет получить занчение LookupField из набора данных LookupSource, если текст в редакторе был выбран из выпадающего списка.
Если текст был введен пользователем вручную, и в lookup-наборе данных нет записей с соответствующим значением поля LookupDisplay, то значение свойства LookupValue равно пустой строке.

При присвоении значения свойству LookupValue, если соответствующее значение найдно в наборе данных, свойству текст присваивается значение поля LookupDisplay.