FGX.SearchEdit.TfgSearchEdit: различия между версиями
Admin (обсуждение | вклад) (summary) |
Admin (обсуждение | вклад) (summary) |
||
Строка 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. | + | <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> |
== Описание == | == Описание == | ||
Строка 31: | Строка 31: | ||
<p>Настройки фильтрации. Актуальны, когда <i>Filtered = True</i> .</p><small style="color: red"><small>Описание взято от [[FGX.SearchEdit.TfgCustomSearchEdit.FilterOptions|FilterOptions]].</small></small> | <p>Настройки фильтрации. Актуальны, когда <i>Filtered = True</i> .</p><small style="color: red"><small>Описание взято от [[FGX.SearchEdit.TfgCustomSearchEdit.FilterOptions|FilterOptions]].</small></small> | ||
|- | |- | ||
− | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Alignment: [[FGX. | + | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Alignment: [[FGX.Controls.Types.TfgControlAlignment|TfgControlAlignment]]</code> |
− | <p>Настройки выравнивания контрола в рамках родителя.</p><small style="color: red"><small>Описание взято от [[FGX. | + | <p>Настройки выравнивания контрола в рамках родителя.</p><small style="color: red"><small>Описание взято от [[FGX.Controls.TfgControl.Alignment|Alignment]].</small></small> |
|- | |- | ||
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>AlignWithMargins: [[Boolean]]</code> | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>AlignWithMargins: [[Boolean]]</code> | ||
− | <p>Нужно ли использовать заданные внешние отступы <i>Margins</i> .</p><small style="color: red"><small>Описание взято от [[FGX. | + | <p>Нужно ли использовать заданные внешние отступы <i>Margins</i> .</p><small style="color: red"><small>Описание взято от [[FGX.Controls.TfgControl.AlignWithMargins|AlignWithMargins]].</small></small> |
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Enabled: [[Boolean]]</code> | ||
+ | <p>Настройка отключения реакции на воздействия пользователя на компонент.</p><small style="color: red"><small>Описание взято от [[FGX.Controls.TfgControl.Enabled|Enabled]].</small></small> | ||
|- | |- | ||
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Locked: [[Boolean]]</code> | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Locked: [[Boolean]]</code> | ||
− | <p>Позволяет заблокировать выделение компонента мышкой в дизайн тайме.</p><small style="color: red"><small>Описание взято от [[FGX. | + | <p>Позволяет заблокировать выделение компонента мышкой в дизайн тайме.</p><small style="color: red"><small>Описание взято от [[FGX.Controls.TfgControl.Locked|Locked]].</small></small> |
|- | |- | ||
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>LookupName: [[string]]</code> | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>LookupName: [[string]]</code> | ||
− | <p>Идентификатор, используемый для поиска данного контрола среди других. Актуально для ситуаций, когда несколько контролов могут иметь одно и тоже имя для поиска и нам нужно найти данный контрол в определенной части поддерева.</p><small style="color: red"><small>Описание взято от [[FGX. | + | <p>Идентификатор, используемый для поиска данного контрола среди других. Актуально для ситуаций, когда несколько контролов могут иметь одно и тоже имя для поиска и нам нужно найти данный контрол в определенной части поддерева.</p><small style="color: red"><small>Описание взято от [[FGX.Controls.TfgControl.LookupName|LookupName]].</small></small> |
|- | |- | ||
− | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>PositionMode: [[FGX. | + | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>PositionMode: [[FGX.Controls.Types.TfgPositionMode|TfgPositionMode]]</code> |
− | <p>Режим позиционирования контрола в рамках родителя (в абсолютных координатах / относительно).</p><small style="color: red"><small>Описание взято от [[FGX. | + | <p>Режим позиционирования контрола в рамках родителя (в абсолютных координатах / относительно).</p><small style="color: red"><small>Описание взято от [[FGX.Controls.TfgControl.PositionMode|PositionMode]].</small></small> |
|- | |- | ||
− | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Position: [[FGX. | + | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Position: [[FGX.Controls.Types.TfgPosition|TfgPosition]]</code> |
− | <p>Позиция контрола в локальных логических координатах родителя <i>Parent</i> .</p><small style="color: red"><small>Описание взято от [[FGX. | + | <p>Позиция контрола в локальных логических координатах родителя <i>Parent</i> .</p><small style="color: red"><small>Описание взято от [[FGX.Controls.TfgControl.Position|Position]].</small></small> |
|- | |- | ||
− | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>RelativePosition: [[FGX. | + | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>RelativePosition: [[FGX.Controls.Types.TfgRelativePosition|TfgRelativePosition]]</code> |
− | <p>Относительная позиция контролов относительно родителя. Актуально только для <b>PositionMode = Relative</b> .</p><small style="color: red"><small>Описание взято от [[FGX. | + | <p>Относительная позиция контролов относительно родителя. Актуально только для <b>PositionMode = Relative</b> .</p><small style="color: red"><small>Описание взято от [[FGX.Controls.TfgControl.RelativePosition|RelativePosition]].</small></small> |
|- | |- | ||
− | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Size: [[FGX. | + | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Size: [[FGX.Controls.Types.TfgSize|TfgSize]]</code> |
− | <p>Размер контрола в логических координатах.</p><small style="color: red"><small>Описание взято от [[FGX. | + | <p>Размер контрола в логических координатах.</p><small style="color: red"><small>Описание взято от [[FGX.Controls.TfgControl.Size|Size]].</small></small> |
|- | |- | ||
− | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Constraints: [[FGX. | + | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Constraints: [[FGX.Controls.Types.TfgConstraints|TfgConstraints]]</code> |
− | <p>Ограничение на размеры контрола.</p><small style="color: red"><small>Описание взято от [[FGX. | + | <p>Ограничение на размеры контрола.</p><small style="color: red"><small>Описание взято от [[FGX.Controls.TfgControl.Constraints|Constraints]].</small></small> |
|- | |- | ||
− | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Margins: [[FGX. | + | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Margins: [[FGX.Controls.Types.TfgMargins|TfgMargins]]</code> |
− | <p>Внешние отступы контрола. Используются при выравнивании текущего контрола в рамках контейнера.</p><small style="color: red"><small>Описание взято от [[FGX. | + | <p>Внешние отступы контрола. Используются при выравнивании текущего контрола в рамках контейнера.</p><small style="color: red"><small>Описание взято от [[FGX.Controls.TfgControl.Margins|Margins]].</small></small> |
|- | |- | ||
− | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>GestureKinds: [[FGX. | + | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>GestureKinds: [[FGX.Controls.TfgGestureKinds|TfgGestureKinds]]</code> |
− | <p>Виды поддерживаемых жестов.</p><small style="color: red"><small>Описание взято от [[FGX. | + | <p>Виды поддерживаемых жестов.</p><small style="color: red"><small>Описание взято от [[FGX.Controls.TfgControl.GestureKinds|GestureKinds]].</small></small> |
|- | |- | ||
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>HitTest: [[Boolean]]</code> | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>HitTest: [[Boolean]]</code> | ||
Строка 68: | Строка 71: | ||
|- | |- | ||
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Opacity: [[Single]]</code> | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Opacity: [[Single]]</code> | ||
− | <p>Прозрачность контрола.</p><small style="color: red"><small>Описание взято от [[FGX. | + | <p>Прозрачность контрола.</p><small style="color: red"><small>Описание взято от [[FGX.Controls.TfgControl.Opacity|Opacity]].</small></small> |
|- | |- | ||
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Visible: [[Boolean]]</code> | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Visible: [[Boolean]]</code> | ||
− | <p>Видимость контрола.</p><small style="color: red"><small>Описание взято от [[FGX. | + | <p>Видимость контрола.</p><small style="color: red"><small>Описание взято от [[FGX.Controls.TfgControl.Visible|Visible]].</small></small> |
|} | |} | ||
Строка 89: | Строка 92: | ||
<p>Вызывается в момент фильтрации предлагаемых слов поиска. По умолчанию, контрол выполняет фильтрацию по <i>TfgSearchEditSuggestion.Text</i> .</p><div class="info">Используйте это событие, если вы хотите переопределить свой собственный вариант фильтрации.</div><small style="color: red"><small>Описание взято от [[FGX.SearchEdit.TfgCustomSearchEdit.OnFilter|OnFilter]].</small></small> | <p>Вызывается в момент фильтрации предлагаемых слов поиска. По умолчанию, контрол выполняет фильтрацию по <i>TfgSearchEditSuggestion.Text</i> .</p><div class="info">Используйте это событие, если вы хотите переопределить свой собственный вариант фильтрации.</div><small style="color: red"><small>Описание взято от [[FGX.SearchEdit.TfgCustomSearchEdit.OnFilter|OnFilter]].</small></small> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnEnter: [[TNotifyEvent]]</code> | ||
+ | <p>Срабатывает, когда контрол получает фокус.</p><small style="color: red"><small>Описание взято от [[FGX.Controls.TfgControl.OnEnter|OnEnter]].</small></small> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnExit: [[TNotifyEvent]]</code> | ||
+ | <p>Срабатывает, когда контрол теряет фокус.</p><small style="color: red"><small>Описание взято от [[FGX.Controls.TfgControl.OnExit|OnExit]].</small></small> | ||
|- | |- | ||
| <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnDestroy: [[TNotifyEvent]]</code> | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnDestroy: [[TNotifyEvent]]</code> | ||
− | <p>Вызывается перед удалением контрола. А именно перед вызовом деструктора.</p><small style="color: red"><small>Описание взято от [[FGX. | + | <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]]</code> | ||
− | <p>Вызывается когда контрол изменил свой размерм.</p><small style="color: red"><small>Описание взято от [[FGX. | + | <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]]</code> | ||
− | <p>Срабатывает, когда пользователь долго нажимает на экран без перемещения пальца по экрану.</p><small style="color: red"><small>Описание взято от [[FGX. | + | <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]]</code> | ||
− | <p>Вызывается когда контрол поменял свою позицию.</p><small style="color: red"><small>Описание взято от [[FGX. | + | <p>Вызывается когда контрол поменял свою позицию.</p><small style="color: red"><small>Описание взято от [[FGX.Controls.TfgControl.OnPositionChanged|OnPositionChanged]].</small></small> |
|- | |- | ||
| <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnTouch: [[Boolean]]</code> | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnTouch: [[Boolean]]</code> | ||
− | <p>Вызывается в момент касания пользователем экрана устройства.</p><small style="color: red"><small>Описание взято от [[FGX. | + | <p>Вызывается в момент касания пользователем экрана устройства.</p><small style="color: red"><small>Описание взято от [[FGX.Controls.TfgControl.OnTouch|OnTouch]].</small></small> |
|- | |- | ||
| <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnTap: [[TNotifyEvent]]</code> | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnTap: [[TNotifyEvent]]</code> | ||
− | <p>Срабатывает, когда пользователь коротко нажимает на экран без перемещения пальца по экрану.</p><small style="color: red"><small>Описание взято от [[FGX. | + | <p>Срабатывает, когда пользователь коротко нажимает на экран без перемещения пальца по экрану.</p><small style="color: red"><small>Описание взято от [[FGX.Controls.TfgControl.OnTap|OnTap]].</small></small> |
|} | |} |
Версия 06:01, 10 июля 2019
Delphi
TfgSearchEdit = class (TfgCustomSearchEdit)
TComponent -> TfgControl -> TfgCustomSearchEdit -> TfgSearchEdit
Описание
Поле ввода строки поиска с поддержкой автозавершения ввода.
Описание взято от TfgCustomSearchEdit.
Свойства
property
|
Text: string
Текущий введенный текст. Описание взято от Text. |
property
|
TextPrompt: string
Тестовая подсказка отображаемая, когда текст еще не введен. Описание взято от TextPrompt. |
property
|
Suggestions: TfgSearchEditSuggestions
Список предлагаемых строк поиска для подстановки. Если у вас большая база предлагаемых строк поиска, то лучшим вариантом по скорости и памяти будет динамическое обновление Suggestions в OnChanging на основании того, что ввел пользователь. При этом вам, возможно, потребуется отключить дефолтную фильтрацию Filtered = False , поскольку вы формируете список вручную. Описание взято от Suggestions.
|
property
|
Filtered: Boolean
Нужно ли фильтровать строки подстановки Suggestions или нет на основании введенного в поле текста? Описание взято от Filtered. |
property
|
FilterOptions: TfgFilterOptions
Настройки фильтрации. Актуальны, когда Filtered = True . Описание взято от FilterOptions. |
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
|
OnChanging: TNotifyEvent
Срабатывает при любом изменении строки поиска. Используйте это событие для динамического формирования списка Suggestions на основании введенных данных пользователем. Описание взято от OnChanging.
|
event
|
OnChanged: TNotifyEvent
Срабатывает в момент подтверждения/отправки запроса поиска. Для Андроида - это либо нажатия на кнопку Return, либо нажатие на кнопку Submit. Описание взято от OnChanged.
|
event
|
OnFilter: TfgSuggestionFilterEvent
Вызывается в момент фильтрации предлагаемых слов поиска. По умолчанию, контрол выполняет фильтрацию по TfgSearchEditSuggestion.Text . Используйте это событие, если вы хотите переопределить свой собственный вариант фильтрации. Описание взято от OnFilter.
|
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: Boolean
Вызывается в момент касания пользователем экрана устройства. Описание взято от OnTouch. |
event
|
OnTap: TNotifyEvent
Срабатывает, когда пользователь коротко нажимает на экран без перемещения пальца по экрану. Описание взято от OnTap. |