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

Материал из FGX Native Докуметации
Перейти к навигации Перейти к поиску
(summary)
(summary)
Строка 28: Строка 28:
  
 
{| class="wikitable sortable"
 
{| class="wikitable sortable"
 +
|-
 +
| <syntaxhighlight lang="Delphi">procedure</syntaxhighlight> || <code lang="Delphi">DropDown()</code>
 +
<p>Открывает выпадающее окно, если в нем есть слова для подстановки.</p>
 +
|-
 +
| <syntaxhighlight lang="Delphi">procedure</syntaxhighlight> || <code lang="Delphi">Close()</code>
 +
<p>Закрывает выпадающее окно.</p>
 
|-
 
|-
 
| <syntaxhighlight lang="Delphi">function</syntaxhighlight> || <code lang="Delphi">IsFiltered(const ASuggestion: [[FGX.AutoCompleteEdit.Types.TfgAutoCompleteEditSuggestion|TfgAutoCompleteEditSuggestion]]; const AFilter: [[string]]): [[Boolean]]</code>
 
| <syntaxhighlight lang="Delphi">function</syntaxhighlight> || <code lang="Delphi">IsFiltered(const ASuggestion: [[FGX.AutoCompleteEdit.Types.TfgAutoCompleteEditSuggestion|TfgAutoCompleteEditSuggestion]]; const AFilter: [[string]]): [[Boolean]]</code>
Строка 36: Строка 42:
  
 
{| class="wikitable sortable"
 
{| class="wikitable sortable"
 +
|-
 +
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>DropDownSize: [[FGX.Types.TfgSingleSize|TfgSingleSize]]</code>
 +
 +
<p>Высота выпадающего окна, отображающего слова подстановки.</p><div class="info">Значение 0 - высота вычисляется автоматически.</div>
 
|-
 
|-
 
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Suggestions: [[FGX.AutoCompleteEdit.Types.TfgAutoCompleteEditSuggestions|TfgAutoCompleteEditSuggestions]]</code>
 
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Suggestions: [[FGX.AutoCompleteEdit.Types.TfgAutoCompleteEditSuggestions|TfgAutoCompleteEditSuggestions]]</code>

Версия 03:13, 6 декабря 2021

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

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