FGX.AutoCompleteEdit.TfgCustomAutoCompleteEdit: различия между версиями
Admin (обсуждение | вклад) (summary) |
Admin (обсуждение | вклад) (summary) |
||
(не показаны 3 промежуточные версии этого же участника) | |||
Строка 6: | Строка 6: | ||
<syntaxhighlight lang="Delphi">TfgCustomAutoCompleteEdit = class (TfgCustomEdit)</syntaxhighlight> | <syntaxhighlight lang="Delphi">TfgCustomAutoCompleteEdit = class (TfgCustomEdit)</syntaxhighlight> | ||
− | <p class="class-inheritance"><span class="type-border">[[System.Classes.TComponent|TComponent]]</span> -> <span class="type-border">[[FGX. | + | <p class="class-inheritance"><span class="type-border">[[System.Classes.TComponent|TComponent]]</span> -> <span class="type-border">[[FGX.Controls.TfgControl|TfgControl]]</span> -> <span class="type-border">[[FGX.Edit.TfgCustomEdit|TfgCustomEdit]]</span> -> <span class="type-border">[[FGX.AutoCompleteEdit.TfgCustomAutoCompleteEdit|TfgCustomAutoCompleteEdit]]</span></p> |
Прямые наследники: | Прямые наследники: | ||
− | [[FGX.AutoCompleteEdit.TfgAutoCompleteEdit|TfgAutoCompleteEdit]] | + | [[FGX.AutoCompleteEdit.TfgAutoCompleteEdit|TfgAutoCompleteEdit]], [[FGX.SearchEdit.TfgCustomSearchEdit|TfgCustomSearchEdit]] |
+ | |||
+ | Непрямые наследники: | ||
+ | [[FGX.SearchEdit.TfgSearchEdit|TfgSearchEdit]] | ||
== Описание == | == Описание == | ||
Строка 25: | Строка 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> | ||
Строка 33: | Строка 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> | ||
Строка 41: | Строка 54: | ||
<p>Нужно ли фильтровать строки подстановки <i>Suggestions</i> или нет на основании введенного в поле текста? Если задано значение <i>False</i> , тогда не зависимо от того, что введет пользователь, выпадающий список будет содержать все слова из списка <i>Suggestions</i> .</p> | <p>Нужно ли фильтровать строки подстановки <i>Suggestions</i> или нет на основании введенного в поле текста? Если задано значение <i>False</i> , тогда не зависимо от того, что введет пользователь, выпадающий список будет содержать все слова из списка <i>Suggestions</i> .</p> | ||
|- | |- | ||
− | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>FilterOptions: [[FGX. | + | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>FilterOptions: [[FGX.AutoCompleteEdit.TfgFilterOptions|TfgFilterOptions]]</code> |
<p>Настройки фильтрации. Актуальны, когда <i>Filtered = True</i> .</p> | <p>Настройки фильтрации. Актуальны, когда <i>Filtered = True</i> .</p> | ||
|} | |} | ||
Строка 49: | Строка 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|TfgSuggestionClickEvent]]</code> | ||
+ | <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
Описание отсутствует. |