FGX.AutoCompleteEdit.TfgCustomAutoCompleteEdit: различия между версиями

Материал из FGX Native Докуметации
Перейти к навигации Перейти к поиску
(summary)
(summary)
 
Строка 62: Строка 62:
 
{| class="wikitable sortable"
 
{| class="wikitable sortable"
 
|-
 
|-
| <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnSuggestionFilter: [[TfgSuggestionFilterEvent]]</code>
+
| <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnSuggestionFilter: [[TfgSuggestionFilterEvent|TfgSuggestionFilterEvent]]</code>
  
 
<p>Вызывается в момент фильтрации предлагаемых слов поиска. По умолчанию, контрол выполняет фильтрацию по <i>TfgAutoCompleteEditSuggestion.Text</i> . Вызывается только, когда <i>Filtered = True</i> .</p><div class="info">Используйте это событие, если вы хотите переопределить свой собственный вариант фильтрации.</div>
 
<p>Вызывается в момент фильтрации предлагаемых слов поиска. По умолчанию, контрол выполняет фильтрацию по <i>TfgAutoCompleteEditSuggestion.Text</i> . Вызывается только, когда <i>Filtered = True</i> .</p><div class="info">Используйте это событие, если вы хотите переопределить свой собственный вариант фильтрации.</div>
 
|-
 
|-
| <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnSuggestionSelected: [[TfgSuggestionClickEvent]]</code>
+
| <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnSuggestionSelected: [[TfgSuggestionClickEvent|TfgSuggestionClickEvent]]</code>
 
<p>Срабатывает, когда пользователь нажимает на предлагаемоем для подстановк слово из выпадающего списка.</p>
 
<p>Срабатывает, когда пользователь нажимает на предлагаемоем для подстановк слово из выпадающего списка.</p>
 
|}
 
|}

Текущая версия на 17:13, 23 декабря 2022

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

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