FGX.AutoCompleteEdit.TfgCustomAutoCompleteEdit

Материал из FGX Native Докуметации
Версия от 17:13, 23 декабря 2022; Admin (обсуждение | вклад) (summary)
(разн.) ← Предыдущая | Текущая версия (разн.) | Следующая → (разн.)
Перейти к навигации Перейти к поиску

Delphi

TfgCustomAutoCompleteEdit = class (TfgCustomEdit)

TComponent -> TfgControl -> TfgCustomEdit -> TfgCustomAutoCompleteEdit

Прямые наследники: TfgAutoCompleteEdit, TfgCustomSearchEdit

Непрямые наследники: TfgSearchEdit

Описание

Поле ввода текста с поддержкой автозавершения ввода.

Конструкторы

constructor
Create(AOwner: TComponent)

Описание отсутствует.

Методы

procedure
DropDown()

Открывает выпадающее окно, если в нем есть слова для подстановки.

procedure
Close()

Закрывает выпадающее окно.

function
IsFiltered(const ASuggestion: TfgAutoCompleteEditSuggestion; const AFilter: string): Boolean

Проверяет, подходит ли предлагаемое слово подстановки ASuggestion для отображения в выпадающем окне согласно текущим настройкам фильтрации. AFilter содержит текущий набранный текст.

Свойства

property
DropDownSize: TfgSingleSize

Высота выпадающего окна, отображающего слова подстановки.

Значение 0 - высота вычисляется автоматически.
property
Suggestions: TfgAutoCompleteEditSuggestions

Список предлагаемых строк поиска для подстановки.

Если у вас большая база предлагаемых строк поиска, то лучшим вариантом по скорости и памяти будет динамическое обновление Suggestions в OnChanging на основании того, что ввел пользователь. При этом вам, возможно, потребуется отключить дефолтную фильтрацию Filtered = False , поскольку вы формируете список вручную.
property
Filtered: Boolean

Нужно ли фильтровать строки подстановки Suggestions или нет на основании введенного в поле текста? Если задано значение False , тогда не зависимо от того, что введет пользователь, выпадающий список будет содержать все слова из списка Suggestions .

property
FilterOptions: TfgFilterOptions

Настройки фильтрации. Актуальны, когда Filtered = True .

События

event
OnSuggestionFilter: TfgSuggestionFilterEvent

Вызывается в момент фильтрации предлагаемых слов поиска. По умолчанию, контрол выполняет фильтрацию по TfgAutoCompleteEditSuggestion.Text . Вызывается только, когда Filtered = True .

Используйте это событие, если вы хотите переопределить свой собственный вариант фильтрации.
event
OnSuggestionSelected: TfgSuggestionClickEvent

Срабатывает, когда пользователь нажимает на предлагаемоем для подстановк слово из выпадающего списка.

Константы

const
DefaultFiltered: Boolean

Описание отсутствует.