FGX.SearchEdit.TfgCustomSearchEdit

Материал из FGX Native Докуметации
Перейти к навигации Перейти к поиску

Delphi

TfgCustomSearchEdit = class (TfgControl)

TComponent -> TfgControl -> TfgCustomSearchEdit

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

Описание

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

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

constructor
Create(AOwner: TComponent)

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

Методы

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

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

Свойства

property
Text: string

Текущий введенный текст.

property
TextPrompt: string

Тестовая подсказка отображаемая, когда текст еще не введен.

property
Suggestions: TfgSearchEditSuggestions

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

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

Нужно ли фильтровать строки подстановки Suggestions или нет на основании введенного в поле текста?

property
FilterOptions: TfgFilterOptions

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

События

event
OnChanging: TNotifyEvent

Срабатывает при любом изменении строки поиска.

Используйте это событие для динамического формирования списка Suggestions на основании введенных данных пользователем.
event
OnChanged: TNotifyEvent

Срабатывает в момент подтверждения/отправки запроса поиска.

Для Андроида - это либо нажатия на кнопку Return, либо нажатие на кнопку Submit.
event
OnFilter: TfgSuggestionFilterEvent

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

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

Константы

const
DefaultFiltered: Boolean

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