FGX.SearchEdit.TfgSearchEdit: различия между версиями
Admin (обсуждение | вклад) (summary) |
Admin (обсуждение | вклад) (summary) |
||
(не показаны 2 промежуточные версии этого же участника) | |||
Строка 6: | Строка 6: | ||
<syntaxhighlight lang="Delphi">TfgSearchEdit = class (TfgCustomSearchEdit)</syntaxhighlight> | <syntaxhighlight lang="Delphi">TfgSearchEdit = class (TfgCustomSearchEdit)</syntaxhighlight> | ||
− | <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.SearchEdit.TfgCustomSearchEdit|TfgCustomSearchEdit]]</span> -> <span class="type-border">[[FGX.SearchEdit.TfgSearchEdit|TfgSearchEdit]]</span></p> | + | <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> -> <span class="type-border">[[FGX.SearchEdit.TfgCustomSearchEdit|TfgCustomSearchEdit]]</span> -> <span class="type-border">[[FGX.SearchEdit.TfgSearchEdit|TfgSearchEdit]]</span></p> |
== Описание == | == Описание == | ||
Строка 14: | Строка 14: | ||
{| class="wikitable sortable" | {| class="wikitable sortable" | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Suggestions: [[FGX.AutoCompleteEdit.Types.TfgAutoCompleteEditSuggestions|TfgAutoCompleteEditSuggestions]]</code> | ||
+ | |||
+ | <p>Список предлагаемых строк поиска для подстановки.</p><div class="info">Если у вас большая база предлагаемых строк поиска, то лучшим вариантом по скорости и памяти будет динамическое обновление <i>Suggestions</i> в <i>OnChanging</i> на основании того, что ввел пользователь. При этом вам, возможно, потребуется отключить дефолтную фильтрацию <i>Filtered = False</i> , поскольку вы формируете список вручную.</div><small style="color: red"><small>Описание взято от [[FGX.AutoCompleteEdit.TfgCustomAutoCompleteEdit.Suggestions|Suggestions]].</small></small> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Filtered: [[Boolean]]</code> | ||
+ | <p>Нужно ли фильтровать строки подстановки <i>Suggestions</i> или нет на основании введенного в поле текста? Если задано значение <i>False</i> , тогда не зависимо от того, что введет пользователь, выпадающий список будет содержать все слова из списка <i>Suggestions</i> .</p><small style="color: red"><small>Описание взято от [[FGX.AutoCompleteEdit.TfgCustomAutoCompleteEdit.Filtered|Filtered]].</small></small> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>FilterOptions: [[FGX.AutoCompleteEdit.TfgFilterOptions|TfgFilterOptions]]</code> | ||
+ | <p>Настройки фильтрации. Актуальны, когда <i>Filtered = True</i> .</p><small style="color: red"><small>Описание взято от [[FGX.AutoCompleteEdit.TfgCustomAutoCompleteEdit.FilterOptions|FilterOptions]].</small></small> | ||
|- | |- | ||
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Text: [[string]]</code> | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Text: [[string]]</code> | ||
− | <p>Текущий введенный текст.</p><small style="color: red"><small>Описание взято от [[FGX. | + | <p>Текущий введенный текст.</p><small style="color: red"><small>Описание взято от [[FGX.Edit.TfgCustomEdit.Text|Text]].</small></small> |
|- | |- | ||
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>TextPrompt: [[string]]</code> | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>TextPrompt: [[string]]</code> | ||
− | <p>Тестовая подсказка отображаемая, когда текст еще не введен.</p><small style="color: red"><small>Описание взято от [[FGX. | + | <p>Тестовая подсказка отображаемая, когда текст еще не введен.</p><small style="color: red"><small>Описание взято от [[FGX.Edit.TfgCustomEdit.TextPrompt|TextPrompt]].</small></small> |
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>BorderStyle: [[FGX.Edit.TfgEditBorderStyle|TfgEditBorderStyle]]</code> | ||
+ | <p>Стиль отображения рамки поля ввода.</p><small style="color: red"><small>Описание взято от [[FGX.Edit.TfgCustomEdit.BorderStyle|BorderStyle]].</small></small> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>ShowVirtualKeyboardOnFocus: [[FGX.Types.TfgPlatformBoolean|TfgPlatformBoolean]]</code> | ||
+ | <p>Показывать ли виртуальную клавиатуру, когда поле ввода получает фокус?</p><small style="color: red"><small>Описание взято от [[FGX.Edit.TfgCustomEdit.ShowVirtualKeyboardOnFocus|ShowVirtualKeyboardOnFocus]].</small></small> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Font: [[FGX.Canvas.Types.TfgFont|TfgFont]]</code> | ||
+ | <p>Параметры шрифта отображения текста.</p><small style="color: red"><small>Описание взято от [[FGX.Edit.TfgCustomEdit.Font|Font]].</small></small> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Color: [[TAlphaColor]]</code> | ||
+ | <p>Цвет отображения текста.</p><small style="color: red"><small>Описание взято от [[FGX.Edit.TfgCustomEdit.Color|Color]].</small></small> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>ColorName: [[TfgAssetName|TfgAssetName]]</code> | ||
+ | <span style="color:gray">Описание отсутствует.</span> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>TextPromptColor: [[TAlphaColor]]</code> | ||
+ | <p>Цвет отображения текстовой подсказки <i>TextPrompt</i> .</p><small style="color: red"><small>Описание взято от [[FGX.Edit.TfgCustomEdit.TextPromptColor|TextPromptColor]].</small></small> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>TextPromptColorName: [[TfgAssetName|TfgAssetName]]</code> | ||
+ | <span style="color:gray">Описание отсутствует.</span> | ||
|- | |- | ||
− | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code> | + | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>TintColorName: [[TfgAssetName|TfgAssetName]]</code> |
− | <p> | + | <p>Ресурс цвета оттенка вкладки.</p><div class="info">Если указан ресурс цвета, то он имеет более высокий приоритет над <i>TintColor</i> . Поэтому именно он и будет использоваться. Если же в ресурсе цвет не указан (Null) или его нет, то будет использоваться <i>TintColor</i> .</div><small style="color: red"><small>Описание взято от [[FGX.Edit.TfgCustomEdit.TintColorName|TintColorName]].</small></small> |
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>TintColor: [[TAlphaColor]]</code> | ||
+ | <p>Цветовой оттенок поля ввода.</p><small style="color: red"><small>Описание взято от [[FGX.Edit.TfgCustomEdit.TintColor|TintColor]].</small></small> | ||
|- | |- | ||
− | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code> | + | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>HorzAlign: [[FGX.Text.TfgHorizontalAlignment|TfgHorizontalAlignment]]</code> |
− | <p> | + | <p>Выравнивание текста по горизонтали.</p><small style="color: red"><small>Описание взято от [[FGX.Edit.TfgCustomEdit.HorzAlign|HorzAlign]].</small></small> |
|- | |- | ||
− | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code> | + | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>VertAlign: [[FGX.Text.TfgVerticalAlignment|TfgVerticalAlignment]]</code> |
− | <p> | + | <p>Выравнивание текста по вертикали.</p><small style="color: red"><small>Описание взято от [[FGX.Edit.TfgCustomEdit.VertAlign|VertAlign]].</small></small> |
|- | |- | ||
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Alignment: [[FGX.Controls.Types.TfgControlAlignment|TfgControlAlignment]]</code> | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Alignment: [[FGX.Controls.Types.TfgControlAlignment|TfgControlAlignment]]</code> | ||
Строка 80: | Строка 114: | ||
{| class="wikitable sortable" | {| class="wikitable sortable" | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnSuggestionFilter: [[TfgSuggestionFilterEvent|TfgSuggestionFilterEvent]]</code> | ||
+ | |||
+ | <p>Вызывается в момент фильтрации предлагаемых слов поиска. По умолчанию, контрол выполняет фильтрацию по <i>TfgAutoCompleteEditSuggestion.Text</i> . Вызывается только, когда <i>Filtered = True</i> .</p><div class="info">Используйте это событие, если вы хотите переопределить свой собственный вариант фильтрации.</div><small style="color: red"><small>Описание взято от [[FGX.AutoCompleteEdit.TfgCustomAutoCompleteEdit.OnSuggestionFilter|OnSuggestionFilter]].</small></small> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnSuggestionSelected: [[TfgSuggestionClickEvent|TfgSuggestionClickEvent]]</code> | ||
+ | <p>Срабатывает, когда пользователь нажимает на предлагаемоем для подстановк слово из выпадающего списка.</p><small style="color: red"><small>Описание взято от [[FGX.AutoCompleteEdit.TfgCustomAutoCompleteEdit.OnSuggestionSelected|OnSuggestionSelected]].</small></small> | ||
|- | |- | ||
| <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnChanging: [[TNotifyEvent]]</code> | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnChanging: [[TNotifyEvent]]</code> | ||
− | + | <p>Срабатывает при любом изменении строки поиска.</p><small style="color: red"><small>Описание взято от [[FGX.Edit.TfgCustomEdit.OnChanging|OnChanging]].</small></small> | |
− | <p>Срабатывает при любом изменении строки поиска.</p | ||
|- | |- | ||
| <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnChanged: [[TNotifyEvent]]</code> | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnChanged: [[TNotifyEvent]]</code> | ||
− | + | <span style="color:gray">Описание отсутствует.</span> | |
− | < | ||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
| <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnEnter: [[TNotifyEvent]]</code> | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnEnter: [[TNotifyEvent]]</code> | ||
Строка 102: | Строка 137: | ||
<p>Вызывается перед удалением контрола. А именно перед вызовом деструктора.</p><small style="color: red"><small>Описание взято от [[FGX.Controls.TfgControl.OnDestroy|OnDestroy]].</small></small> | <p>Вызывается перед удалением контрола. А именно перед вызовом деструктора.</p><small style="color: red"><small>Описание взято от [[FGX.Controls.TfgControl.OnDestroy|OnDestroy]].</small></small> | ||
|- | |- | ||
− | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnResized: [[TfgResizedEvent]]</code> | + | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnResized: [[TfgResizedEvent|TfgResizedEvent]]</code> |
<p>Вызывается когда контрол изменил свой размерм.</p><small style="color: red"><small>Описание взято от [[FGX.Controls.TfgControl.OnResized|OnResized]].</small></small> | <p>Вызывается когда контрол изменил свой размерм.</p><small style="color: red"><small>Описание взято от [[FGX.Controls.TfgControl.OnResized|OnResized]].</small></small> | ||
|- | |- | ||
− | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnLongTap: [[TfgLongTapEvent]]</code> | + | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnLongTap: [[TfgLongTapEvent|TfgLongTapEvent]]</code> |
<p>Срабатывает, когда пользователь долго нажимает на экран без перемещения пальца по экрану.</p><small style="color: red"><small>Описание взято от [[FGX.Controls.TfgControl.OnLongTap|OnLongTap]].</small></small> | <p>Срабатывает, когда пользователь долго нажимает на экран без перемещения пальца по экрану.</p><small style="color: red"><small>Описание взято от [[FGX.Controls.TfgControl.OnLongTap|OnLongTap]].</small></small> | ||
|- | |- | ||
− | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnPositionChanged: [[TfgPositionChangedEvent]]</code> | + | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnPositionChanged: [[TfgPositionChangedEvent|TfgPositionChangedEvent]]</code> |
<p>Вызывается когда контрол поменял свою позицию.</p><small style="color: red"><small>Описание взято от [[FGX.Controls.TfgControl.OnPositionChanged|OnPositionChanged]].</small></small> | <p>Вызывается когда контрол поменял свою позицию.</p><small style="color: red"><small>Описание взято от [[FGX.Controls.TfgControl.OnPositionChanged|OnPositionChanged]].</small></small> | ||
|- | |- | ||
− | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnTouch: [[ | + | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnTouch: [[TfgTouchEvent|TfgTouchEvent]]</code> |
<p>Вызывается в момент касания пользователем экрана устройства.</p><small style="color: red"><small>Описание взято от [[FGX.Controls.TfgControl.OnTouch|OnTouch]].</small></small> | <p>Вызывается в момент касания пользователем экрана устройства.</p><small style="color: red"><small>Описание взято от [[FGX.Controls.TfgControl.OnTouch|OnTouch]].</small></small> | ||
|- | |- |
Текущая версия на 17:25, 23 декабря 2022
Delphi
TfgSearchEdit = class (TfgCustomSearchEdit)
TComponent -> TfgControl -> TfgCustomEdit -> TfgCustomAutoCompleteEdit -> TfgCustomSearchEdit -> TfgSearchEdit
Описание
Поле ввода строки поиска с поддержкой автозавершения ввода.
Описание взято от TfgCustomSearchEdit.
Свойства
property
|
Suggestions: TfgAutoCompleteEditSuggestions
Список предлагаемых строк поиска для подстановки. Если у вас большая база предлагаемых строк поиска, то лучшим вариантом по скорости и памяти будет динамическое обновление Suggestions в OnChanging на основании того, что ввел пользователь. При этом вам, возможно, потребуется отключить дефолтную фильтрацию Filtered = False , поскольку вы формируете список вручную. Описание взято от Suggestions.
|
property
|
Filtered: Boolean
Нужно ли фильтровать строки подстановки Suggestions или нет на основании введенного в поле текста? Если задано значение False , тогда не зависимо от того, что введет пользователь, выпадающий список будет содержать все слова из списка Suggestions . Описание взято от Filtered. |
property
|
FilterOptions: TfgFilterOptions
Настройки фильтрации. Актуальны, когда Filtered = True . Описание взято от FilterOptions. |
property
|
Text: string
Текущий введенный текст. Описание взято от Text. |
property
|
TextPrompt: string
Тестовая подсказка отображаемая, когда текст еще не введен. Описание взято от TextPrompt. |
property
|
BorderStyle: TfgEditBorderStyle
Стиль отображения рамки поля ввода. Описание взято от BorderStyle. |
property
|
ShowVirtualKeyboardOnFocus: TfgPlatformBoolean
Показывать ли виртуальную клавиатуру, когда поле ввода получает фокус? Описание взято от ShowVirtualKeyboardOnFocus. |
property
|
Font: TfgFont
Параметры шрифта отображения текста. Описание взято от Font. |
property
|
Color: TAlphaColor
Цвет отображения текста. Описание взято от Color. |
property
|
ColorName: TfgAssetName
Описание отсутствует. |
property
|
TextPromptColor: TAlphaColor
Цвет отображения текстовой подсказки TextPrompt . Описание взято от TextPromptColor. |
property
|
TextPromptColorName: TfgAssetName
Описание отсутствует. |
property
|
TintColorName: TfgAssetName
Ресурс цвета оттенка вкладки. Если указан ресурс цвета, то он имеет более высокий приоритет над TintColor . Поэтому именно он и будет использоваться. Если же в ресурсе цвет не указан (Null) или его нет, то будет использоваться TintColor . Описание взято от TintColorName.
|
property
|
TintColor: TAlphaColor
Цветовой оттенок поля ввода. Описание взято от TintColor. |
property
|
HorzAlign: TfgHorizontalAlignment
Выравнивание текста по горизонтали. Описание взято от HorzAlign. |
property
|
VertAlign: TfgVerticalAlignment
Выравнивание текста по вертикали. Описание взято от VertAlign. |
property
|
Alignment: TfgControlAlignment
Настройки выравнивания контрола в рамках родителя. Описание взято от Alignment. |
property
|
AlignWithMargins: Boolean
Нужно ли использовать заданные внешние отступы Margins . Описание взято от AlignWithMargins. |
property
|
Enabled: Boolean
Настройка отключения реакции на воздействия пользователя на компонент. Описание взято от Enabled. |
property
|
Locked: Boolean
Позволяет заблокировать выделение компонента мышкой в дизайн тайме. Описание взято от Locked. |
property
|
LookupName: string
Идентификатор, используемый для поиска данного контрола среди других. Актуально для ситуаций, когда несколько контролов могут иметь одно и тоже имя для поиска и нам нужно найти данный контрол в определенной части поддерева. Описание взято от LookupName. |
property
|
PositionMode: TfgPositionMode
Режим позиционирования контрола в рамках родителя (в абсолютных координатах / относительно). Описание взято от PositionMode. |
property
|
Position: TfgPosition
Позиция контрола в локальных логических координатах родителя Parent . Описание взято от Position. |
property
|
RelativePosition: TfgRelativePosition
Относительная позиция контролов относительно родителя. Актуально только для PositionMode = Relative . Описание взято от RelativePosition. |
property
|
Size: TfgSize
Размер контрола в логических координатах. Описание взято от Size. |
property
|
Constraints: TfgConstraints
Ограничение на размеры контрола. Описание взято от Constraints. |
property
|
Margins: TfgMargins
Внешние отступы контрола. Используются при выравнивании текущего контрола в рамках контейнера. Описание взято от Margins. |
property
|
GestureKinds: TfgGestureKinds
Виды поддерживаемых жестов. Описание взято от GestureKinds. |
property
|
HitTest: Boolean
Описание отсутствует. |
property
|
Opacity: Single
Прозрачность контрола. Описание взято от Opacity. |
property
|
Visible: Boolean
Видимость контрола. Описание взято от Visible. |
События
event
|
OnSuggestionFilter: TfgSuggestionFilterEvent
Вызывается в момент фильтрации предлагаемых слов поиска. По умолчанию, контрол выполняет фильтрацию по TfgAutoCompleteEditSuggestion.Text . Вызывается только, когда Filtered = True . Используйте это событие, если вы хотите переопределить свой собственный вариант фильтрации. Описание взято от OnSuggestionFilter.
|
event
|
OnSuggestionSelected: TfgSuggestionClickEvent
Срабатывает, когда пользователь нажимает на предлагаемоем для подстановк слово из выпадающего списка. Описание взято от OnSuggestionSelected. |
event
|
OnChanging: TNotifyEvent
Срабатывает при любом изменении строки поиска. Описание взято от OnChanging. |
event
|
OnChanged: TNotifyEvent
Описание отсутствует. |
event
|
OnEnter: TNotifyEvent
Срабатывает, когда контрол получает фокус. Описание взято от OnEnter. |
event
|
OnExit: TNotifyEvent
Срабатывает, когда контрол теряет фокус. Описание взято от OnExit. |
event
|
OnDestroy: TNotifyEvent
Вызывается перед удалением контрола. А именно перед вызовом деструктора. Описание взято от OnDestroy. |
event
|
OnResized: TfgResizedEvent
Вызывается когда контрол изменил свой размерм. Описание взято от OnResized. |
event
|
OnLongTap: TfgLongTapEvent
Срабатывает, когда пользователь долго нажимает на экран без перемещения пальца по экрану. Описание взято от OnLongTap. |
event
|
OnPositionChanged: TfgPositionChangedEvent
Вызывается когда контрол поменял свою позицию. Описание взято от OnPositionChanged. |
event
|
OnTouch: TfgTouchEvent
Вызывается в момент касания пользователем экрана устройства. Описание взято от OnTouch. |
event
|
OnTap: TNotifyEvent
Срабатывает, когда пользователь коротко нажимает на экран без перемещения пальца по экрану. Описание взято от OnTap. |