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

Материал из FGX Native Докуметации
Перейти к навигации Перейти к поиску
(summary)
(summary)
(Метка: замена)
Строка 7: Строка 7:
  
 
<p class="class-inheritance"><span class="type-border">[[System.Classes.TComponent|TComponent]]</span> -> <span class="type-border">[[FGX.Control.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.Control.TfgControl|TfgControl]]</span> -> <span class="type-border">[[FGX.SearchEdit.TfgCustomSearchEdit|TfgCustomSearchEdit]]</span> -> <span class="type-border">[[FGX.SearchEdit.TfgSearchEdit|TfgSearchEdit]]</span></p>
 
== Описание ==
 
 
<p>Поле ввода строки поиска с поддержкой автозавершения ввода.</p><small style="color: red"><small>Описание взято от [[FGX.SearchEdit.TfgCustomSearchEdit|TfgCustomSearchEdit]].</small></small>
 
 
== Свойства ==
 
 
{| class="wikitable sortable"
 
|-
 
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Text: [[string]]</code>
 
<p>Текущий введенный текст.</p><small style="color: red"><small>Описание взято от [[FGX.SearchEdit.TfgCustomSearchEdit.Text|Text]].</small></small>
 
|-
 
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>TextPrompt: [[string]]</code>
 
<p>Тестовая подсказка отображаемая, когда текст еще не введен.</p><small style="color: red"><small>Описание взято от [[FGX.SearchEdit.TfgCustomSearchEdit.TextPrompt|TextPrompt]].</small></small>
 
|-
 
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Suggestions: [[FGX.SearchEdit.Types.TfgSearchEditSuggestions|TfgSearchEditSuggestions]]</code>
 
 
<p>Список предлагаемых строк поиска для подстановки.</p><div class="info">Если у вас большая база предлагаемых строк поиска, то лучшим вариантом по скорости и памяти будет динамическое обновление <i>Suggestions</i> в <i>OnChanging</i> на основании того, что ввел пользователь. При этом вам, возможно, потребуется отключить дефолтную фильтрацию <i>Filtered = False</i> , поскольку вы формируете список вручную.</div><small style="color: red"><small>Описание взято от [[FGX.SearchEdit.TfgCustomSearchEdit.Suggestions|Suggestions]].</small></small>
 
|-
 
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Filtered: [[Boolean]]</code>
 
<p>Нужно ли фильтровать строки подстановки <i>Suggestions</i> или нет на основании введенного в поле текста?</p><small style="color: red"><small>Описание взято от [[FGX.SearchEdit.TfgCustomSearchEdit.Filtered|Filtered]].</small></small>
 
|-
 
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>FilterOptions: [[FGX.SearchEdit.TfgFilterOptions|TfgFilterOptions]]</code>
 
<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.Control.Types.TfgControlAlignment|TfgControlAlignment]]</code>
 
<p>Настройки выравнивания контрола в рамках родителя.</p><small style="color: red"><small>Описание взято от [[FGX.Control.TfgControl.Alignment|Alignment]].</small></small>
 
|-
 
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>AlignWithMargins: [[Boolean]]</code>
 
<p>Нужно ли использовать заданные внешние отступы <i>Margins</i> .</p><small style="color: red"><small>Описание взято от [[FGX.Control.TfgControl.AlignWithMargins|AlignWithMargins]].</small></small>
 
|-
 
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Locked: [[Boolean]]</code>
 
<p>Позволяет заблокировать выделение компонента мышкой в дизайн тайме.</p><small style="color: red"><small>Описание взято от [[FGX.Control.TfgControl.Locked|Locked]].</small></small>
 
|-
 
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>LookupName: [[string]]</code>
 
<p>Идентификатор, используемый для поиска данного контрола среди других. Актуально для ситуаций, когда несколько контролов могут иметь одно и тоже имя для поиска и нам нужно найти данный контрол в определенной части поддерева.</p><small style="color: red"><small>Описание взято от [[FGX.Control.TfgControl.LookupName|LookupName]].</small></small>
 
|-
 
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>PositionMode: [[FGX.Control.Types.TfgPositionMode|TfgPositionMode]]</code>
 
<p>Режим позиционирования контрола в рамках родителя (в абсолютных координатах / относительно).</p><small style="color: red"><small>Описание взято от [[FGX.Control.TfgControl.PositionMode|PositionMode]].</small></small>
 
|-
 
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Position: [[FGX.Control.Types.TfgPosition|TfgPosition]]</code>
 
<p>Позиция контрола в локальных логических координатах родителя <i>Parent</i> .</p><small style="color: red"><small>Описание взято от [[FGX.Control.TfgControl.Position|Position]].</small></small>
 
|-
 
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>RelativePosition: [[FGX.Control.Types.TfgRelativePosition|TfgRelativePosition]]</code>
 
<p>Относительная позиция контролов относительно родителя. Актуально только для <b>PositionMode = Relative</b> .</p><small style="color: red"><small>Описание взято от [[FGX.Control.TfgControl.RelativePosition|RelativePosition]].</small></small>
 
|-
 
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Size: [[FGX.Control.Types.TfgSize|TfgSize]]</code>
 
<p>Размер контрола в логических координатах.</p><small style="color: red"><small>Описание взято от [[FGX.Control.TfgControl.Size|Size]].</small></small>
 
|-
 
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Constraints: [[FGX.Control.Types.TfgConstraints|TfgConstraints]]</code>
 
<p>Ограничение на размеры контрола.</p><small style="color: red"><small>Описание взято от [[FGX.Control.TfgControl.Constraints|Constraints]].</small></small>
 
|-
 
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Margins: [[FGX.Control.Types.TfgMargins|TfgMargins]]</code>
 
<p>Внешние отступы контрола. Используются при выравнивании текущего контрола в рамках контейнера.</p><small style="color: red"><small>Описание взято от [[FGX.Control.TfgControl.Margins|Margins]].</small></small>
 
|-
 
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>GestureKinds: [[FGX.Control.TfgGestureKinds|TfgGestureKinds]]</code>
 
<p>Виды поддерживаемых жестов.</p><small style="color: red"><small>Описание взято от [[FGX.Control.TfgControl.GestureKinds|GestureKinds]].</small></small>
 
|-
 
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>HitTest: [[Boolean]]</code>
 
<span style="color:gray">Описание отсутствует.</span>
 
|-
 
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Opacity: [[Single]]</code>
 
<p>Прозрачность контрола.</p><small style="color: red"><small>Описание взято от [[FGX.Control.TfgControl.Opacity|Opacity]].</small></small>
 
|-
 
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Visible: [[Boolean]]</code>
 
<p>Видимость контрола.</p><small style="color: red"><small>Описание взято от [[FGX.Control.TfgControl.Visible|Visible]].</small></small>
 
|}
 
 
== События ==
 
 
{| class="wikitable sortable"
 
|-
 
| <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnChanging: [[TNotifyEvent]]</code>
 
 
<p>Срабатывает при любом изменении строки поиска.</p><div class="info">Используйте это событие для динамического формирования списка <i>Suggestions</i> на основании введенных данных пользователем.</div><small style="color: red"><small>Описание взято от [[FGX.SearchEdit.TfgCustomSearchEdit.OnChanging|OnChanging]].</small></small>
 
|-
 
| <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnChanged: [[TNotifyEvent]]</code>
 
 
<p>Срабатывает в момент подтверждения/отправки запроса поиска.</p><div class="info">Для Андроида - это либо нажатия на кнопку Return, либо нажатие на кнопку Submit.</div><small style="color: red"><small>Описание взято от [[FGX.SearchEdit.TfgCustomSearchEdit.OnChanged|OnChanged]].</small></small>
 
|-
 
| <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnFilter: [[TfgSuggestionFilterEvent]]</code>
 
 
<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>OnDestroy: [[TNotifyEvent]]</code>
 
<p>Вызывается перед удалением контрола. А именно перед вызовом деструктора.</p><small style="color: red"><small>Описание взято от [[FGX.Control.TfgControl.OnDestroy|OnDestroy]].</small></small>
 
|-
 
| <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnResized: [[TfgResizedEvent]]</code>
 
<p>Вызывается когда контрол изменил свой размерм.</p><small style="color: red"><small>Описание взято от [[FGX.Control.TfgControl.OnResized|OnResized]].</small></small>
 
|-
 
| <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnPaint: [[TfgPaintEvent]]</code>
 
<p>Вызывается после отрисовки нативного контрола. Служит для выполнения пользовательской отрисовки поверх контрола.</p><small style="color: red"><small>Описание взято от [[FGX.Control.TfgControl.OnPaint|OnPaint]].</small></small>
 
|-
 
| <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnLongTap: [[TfgLongTapEvent]]</code>
 
<p>Срабатывает, когда пользователь долго нажимает на экран без перемещения пальца по экрану.</p><small style="color: red"><small>Описание взято от [[FGX.Control.TfgControl.OnLongTap|OnLongTap]].</small></small>
 
|-
 
| <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnPositionChanged: [[TfgPositionChangedEvent]]</code>
 
<p>Вызывается когда контрол поменял свою позицию.</p><small style="color: red"><small>Описание взято от [[FGX.Control.TfgControl.OnPositionChanged|OnPositionChanged]].</small></small>
 
|-
 
| <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnTouch: [[Boolean]]</code>
 
<p>Вызывается в момент касания пользователем экрана устройства.</p><small style="color: red"><small>Описание взято от [[FGX.Control.TfgControl.OnTouch|OnTouch]].</small></small>
 
|-
 
| <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnTap: [[TNotifyEvent]]</code>
 
<p>Срабатывает, когда пользователь коротко нажимает на экран без перемещения пальца по экрану.</p><small style="color: red"><small>Описание взято от [[FGX.Control.TfgControl.OnTap|OnTap]].</small></small>
 
|}
 

Версия 18:17, 29 июня 2019