FGX.SearchEdit.TfgCustomSearchEdit: различия между версиями
Admin (обсуждение | вклад) (summary) |
Admin (обсуждение | вклад) (summary) |
||
Строка 50: | Строка 50: | ||
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>FilterOptions: [[FGX.SearchEdit.TfgFilterOptions|TfgFilterOptions]]</code> | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>FilterOptions: [[FGX.SearchEdit.TfgFilterOptions|TfgFilterOptions]]</code> | ||
<p>Настройки фильтрации. Актуальны, когда <i>Filtered = True</i> .</p> | <p>Настройки фильтрации. Актуальны, когда <i>Filtered = True</i> .</p> | ||
+ | |} | ||
+ | |||
+ | == События == | ||
+ | |||
+ | {| class="wikitable sortable" | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnChanging: [[TNotifyEvent]]</code> | ||
+ | |||
+ | <p>Срабатывает при любом изменении строки поиска.</p><div class="info">Используйте это событие для динамического формирования списка <i>Suggestions</i> на основании введенных данных пользователем.</div> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnChanged: [[TNotifyEvent]]</code> | ||
+ | |||
+ | <p>Срабатывает в момент подтверждения/отправки запроса поиска.</p><div class="info">Для Андроида - это либо нажатия на кнопку Return, либо нажатие на кнопку Submit.</div> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnFilter: [[TfgSuggestionFilterEvent]]</code> | ||
+ | |||
+ | <p>Вызывается в момент фильтрации предлагаемых слов поиска. По умолчанию, контрол выполняет фильтрацию по <i>TfgSearchEditSuggestion.Text</i> .</p><div class="info">Используйте это событие, если вы хотите переопределить свой собственный вариант фильтрации.</div> | ||
|} | |} |
Версия 18:17, 29 июня 2019
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 . Используйте это событие, если вы хотите переопределить свой собственный вариант фильтрации.
|