FGX.CollectionView.TfgCollectionView: различия между версиями
Admin (обсуждение | вклад) (summary) |
Admin (обсуждение | вклад) (summary) |
||
(не показано 15 промежуточных версий этого же участника) | |||
Строка 6: | Строка 6: | ||
<syntaxhighlight lang="Delphi">TfgCollectionView = class (TfgCustomCollectionView)</syntaxhighlight> | <syntaxhighlight lang="Delphi">TfgCollectionView = class (TfgCustomCollectionView)</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.CollectionView.TfgCustomCollectionView|TfgCustomCollectionView]]</span> -> <span class="type-border">[[FGX.CollectionView.TfgCollectionView|TfgCollectionView]]</span></p> |
== Описание == | == Описание == | ||
<span style="color:gray">Описание отсутствует.</span> | <span style="color:gray">Описание отсутствует.</span> | ||
− | |||
== Свойства == | == Свойства == | ||
{| class="wikitable sortable" | {| class="wikitable sortable" | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>ColumnsCount: [[Integer]]</code> | ||
+ | <p>Количество столбцов, по которым размещаются элементы списка.</p><small style="color: red"><small>Описание взято от [[FGX.CollectionView.TfgCustomCollectionView.ColumnsCount|ColumnsCount]].</small></small> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>DragOptions: [[FGX.CollectionView.TfgDragAndDropOptions|TfgDragAndDropOptions]]</code> | ||
+ | <p>Настройки фунционала перетаскивания элементов между собой.</p><small style="color: red"><small>Описание взято от [[FGX.CollectionView.TfgCustomCollectionView.DragOptions|DragOptions]].</small></small> | ||
|- | |- | ||
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>PullToRefreshOptions: [[FGX.CollectionView.TfgPullToRefreshOptions|TfgPullToRefreshOptions]]</code> | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>PullToRefreshOptions: [[FGX.CollectionView.TfgPullToRefreshOptions|TfgPullToRefreshOptions]]</code> | ||
− | <p>Настройки режима обновления списка "Потяни и обнови".</p><small style="color: red"><small>Описание взято от [[FGX.CollectionView.TfgCustomCollectionView.PullToRefreshOptions|PullToRefreshOptions]].</small> | + | <p>Настройки режима обновления списка "Потяни и обнови".</p><small style="color: red"><small>Описание взято от [[FGX.CollectionView.TfgCustomCollectionView.PullToRefreshOptions|PullToRefreshOptions]].</small></small> |
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Padding: [[FGX.Layout.Types.TfgPadding|TfgPadding]]</code> | ||
+ | <p>Внутренние отступы, учитывающиеся при выравнивании элементов.</p><small style="color: red"><small>Описание взято от [[FGX.CollectionView.TfgCustomCollectionView.Padding|Padding]].</small></small> | ||
|- | |- | ||
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>ScrollGlowColor: [[TAlphaColor]]</code> | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>ScrollGlowColor: [[TAlphaColor]]</code> | ||
− | <p>Цвет эффекта прокручивания списка, который появляется при попытке прокрутить список за его границы.</p><div class="info">Актуально только для Андроид платформы.</div><small style="color: red"><small>Описание взято от [[FGX.CollectionView.TfgCustomCollectionView.ScrollGlowColor|ScrollGlowColor]].</small> | + | <p>Цвет эффекта прокручивания списка, который появляется при попытке прокрутить список за его границы.</p><div class="info">Актуально только для Андроид платформы.</div><small style="color: red"><small>Описание взято от [[FGX.CollectionView.TfgCustomCollectionView.ScrollGlowColor|ScrollGlowColor]].</small></small> |
|- | |- | ||
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>ScrollGlowColorName: [[TfgAssetName|TfgAssetName]]</code> | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>ScrollGlowColorName: [[TfgAssetName|TfgAssetName]]</code> | ||
<span style="color:gray">Описание отсутствует.</span> | <span style="color:gray">Описание отсутствует.</span> | ||
|- | |- | ||
− | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>SelectionMode: [[TfgCollectionViewSelectionMode|TfgCollectionViewSelectionMode]]</code> | + | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>SelectionOptions: [[FGX.CollectionView.TfgSelectionOptions|TfgSelectionOptions]]</code> |
− | <p>Режим выделения элементов. Всего существует три способа выделения:</p> <ul><li><b>None</b> - Элементы не поддерживают выделение.</li> <li><b>SingleSelect</b> - Только один элемент может быть выделени. При этом при попытке выделить другой элемент выделение с предыдущего сбрасывается.</li> <li><b>MultiSelect</b> - Поддерживается выделение любого количества элементов.</li></ul><small style="color: red"><small>Описание взято от [[FGX.CollectionView.TfgCustomCollectionView.SelectionMode|SelectionMode]].</small> | + | <p>Настройки выделения.</p><small style="color: red"><small>Описание взято от [[FGX.CollectionView.TfgCustomCollectionView.SelectionOptions|SelectionOptions]].</small></small> |
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>SelectionMode: [[FGX.CollectionView.TfgCollectionViewSelectionMode|TfgCollectionViewSelectionMode]]</code> | ||
+ | <p>Режим выделения элементов. Всего существует три способа выделения:</p> <ul><li><b>None</b> - Элементы не поддерживают выделение.</li> <li><b>SingleSelect</b> - Только один элемент может быть выделени. При этом при попытке выделить другой элемент выделение с предыдущего сбрасывается.</li> <li><b>MultiSelect</b> - Поддерживается выделение любого количества элементов.</li></ul><small style="color: red"><small>Описание взято от [[FGX.CollectionView.TfgCustomCollectionView.SelectionMode|SelectionMode]].</small></small> | ||
|- | |- | ||
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>SelectionColor: [[TAlphaColor]]</code> | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>SelectionColor: [[TAlphaColor]]</code> | ||
− | <p>Общий цвет выделение элементов по умолчанию. Каждый стиль элемента может переопределить это значение через аналогичное свойство <i>TfgCollectionViewStyle.SelectionColor</i> .</p><div class="info">Если указан цвет <i>TAlphaColorRec.Null</i> , то компонент будет использовать системный цвет для выделения, который зависит от платформы и версии ОС.</div><small style="color: red"><small>Описание взято от [[FGX.CollectionView.TfgCustomCollectionView.SelectionColor|SelectionColor]].</small> | + | <p>Общий цвет выделение элементов по умолчанию. Каждый стиль элемента может переопределить это значение через аналогичное свойство <i>TfgCollectionViewStyle.SelectionColor</i> .</p><div class="info">Если указан цвет <i>TAlphaColorRec.Null</i> , то компонент будет использовать системный цвет для выделения, который зависит от платформы и версии ОС.</div><small style="color: red"><small>Описание взято от [[FGX.CollectionView.TfgCustomCollectionView.SelectionColor|SelectionColor]].</small></small> |
|- | |- | ||
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>SelectionColorName: [[TfgAssetName|TfgAssetName]]</code> | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>SelectionColorName: [[TfgAssetName|TfgAssetName]]</code> | ||
− | <p>Название ресурса цвета выделения элементов в контроле.</p><small style="color: red"><small>Описание взято от [[FGX.CollectionView.TfgCustomCollectionView.SelectionColorName|SelectionColorName]].</small> | + | <p>Название ресурса цвета выделения элементов в контроле.</p><small style="color: red"><small>Описание взято от [[FGX.CollectionView.TfgCustomCollectionView.SelectionColorName|SelectionColorName]].</small></small> |
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>HorzScrollBar: [[FGX.Types.Scroll.TfgScrollBarSettings|TfgScrollBarSettings]]</code> | ||
+ | <p>Настройки отображения горизонтальной полосы прокрутки.</p><small style="color: red"><small>Описание взято от [[FGX.CollectionView.TfgCustomCollectionView.HorzScrollBar|HorzScrollBar]].</small></small> | ||
|- | |- | ||
− | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Alignment: [[FGX. | + | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>VertScrollBar: [[FGX.Types.Scroll.TfgScrollBarSettings|TfgScrollBarSettings]]</code> |
− | <p>Настройки выравнивания контрола в рамках родителя.</p><small style="color: red"><small>Описание взято от [[FGX. | + | <p>Настройки отображения вертикальной полосы прокрутки.</p><small style="color: red"><small>Описание взято от [[FGX.CollectionView.TfgCustomCollectionView.VertScrollBar|VertScrollBar]].</small></small> |
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Alignment: [[FGX.Controls.Types.TfgControlAlignment|TfgControlAlignment]]</code> | ||
+ | <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>BackgroundName: [[TfgAssetName|TfgAssetName]]</code> | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>BackgroundName: [[TfgAssetName|TfgAssetName]]</code> | ||
− | <p>Настройки отображения заднего фона контрола.</p><small style="color: red"><small>Описание взято от [[FGX. | + | <p>Настройки отображения заднего фона контрола.</p><small style="color: red"><small>Описание взято от [[FGX.Controls.TfgControl.BackgroundName|BackgroundName]].</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: [[TfgPositionMode|TfgPositionMode]]</code> | + | | <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: [[TfgGestureKinds|TfgGestureKinds]]</code> | + | | <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> | ||
Строка 76: | Строка 96: | ||
|- | |- | ||
| <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> |
+ | |} | ||
+ | |||
+ | == События == | ||
+ | |||
+ | {| class="wikitable sortable" | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnGetItemCount: [[Integer]]</code> | ||
+ | |||
+ | <p>Через это событие компонент запрашивает общее количество элементов, которые необходимо отобразить.</p><div class="info">Компонент постоянно использует это событие для получения количества элементов. Поэтому избегайте практики долгого вычисления количества. Это может сказать на скорости прокрутки списка.</div><small style="color: red"><small>Описание взято от [[FGX.CollectionView.TfgCustomCollectionView.OnGetItemCount|OnGetItemCount]].</small></small> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnGetItemId: [[TfgGetItemIdEvent|TfgGetItemIdEvent]]</code> | ||
+ | |||
+ | <p>Через это событие компонент запрашивает уникальный идентификатор элемента. Эта информация может использоваться контролом для визуального выделения изменения элементов на экране при обновлении списка. По мимо этот идентификтор используется для корректного выделения элементов в случае, когда пользователь меняет данные элементов, добавляет или удаляет их.</p><div class="info">Обязательно должен быть уникальным среди идентификаторов всех элементов!</div><small style="color: red"><small>Описание взято от [[FGX.CollectionView.TfgCustomCollectionView.OnGetItemId|OnGetItemId]].</small></small> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnGetItemStyle: [[string]]</code> | ||
+ | |||
+ | <p>Через это событие компонент запрашивает название стиля, которое необходимо применить к элементу по указанному индексу.</p><div class="info">Компонент использует это событие в момент, когда указанный элемент готовится появится на экране. Обратите внимание, что если у вас в коллекции используется только один стиль, то это событие можно не использовать. Компонент автоматически выберет первый стиль, если вы не используете это событие.</div><small style="color: red"><small>Описание взято от [[FGX.CollectionView.TfgCustomCollectionView.OnGetItemStyle|OnGetItemStyle]].</small></small> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnBindItem: [[TfgBindItemEvent|TfgBindItemEvent]]</code> | ||
+ | |||
+ | <p>Через это событие происходит связь пользовательских данных с конкретным элементом списка по указанному индексу.</p><div class="info">Все необходимые данные для отображения должны быть уже предварительно загружены и приготовлены к отображению. В этом событие необходимо связать готовые данные с конкретными контролами.</div><small style="color: red"><small>Описание взято от [[FGX.CollectionView.TfgCustomCollectionView.OnBindItem|OnBindItem]].</small></small> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnTapItem: [[TfgItemTapEvent|TfgItemTapEvent]]</code> | ||
+ | <p>Пользователь нажал на элемент списка.</p><small style="color: red"><small>Описание взято от [[FGX.CollectionView.TfgCustomCollectionView.OnTapItem|OnTapItem]].</small></small> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnLongTapItem: [[TfgItemLongTapEvent|TfgItemLongTapEvent]]</code> | ||
+ | |||
+ | <p>Пользователь выполнил долгое нажатие на элемент списка.</p><div class="info">Данное событие работает автоматически. Не нужно отдельно включать значение <i>LongTap</i> в <i>GestureKinds</i> . Особенностью работы данного события - является события даже если долгое нажатие произведено на вложенный в элемент контрол, перехватывающий LongTap.</div><small style="color: red"><small>Описание взято от [[FGX.CollectionView.TfgCustomCollectionView.OnLongTapItem|OnLongTapItem]].</small></small> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnUpdateItemSelectionAppearance: [[TfgUpdateItemSelectionAppearanceEvent|TfgUpdateItemSelectionAppearanceEvent]]</code> | ||
+ | <p>Необходимо вручную выполнить визуальное отображение/сброс выделение указаного элемента списка. Данное событие вызывается только при режиме <i>SelectionOptions.PaintingMode = Manual</i> .</p><small style="color: red"><small>Описание взято от [[FGX.CollectionView.TfgCustomCollectionView.OnUpdateItemSelectionAppearance|OnUpdateItemSelectionAppearance]].</small></small> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnSelectionChanged: [[TfgSelectionChangedEvent|TfgSelectionChangedEvent]]</code> | ||
+ | <p>Пользователь совершил выделение одного или нескольких элементов списка. За возможность выделения элемента отвечает свойство стиля <i>TfgCollectionViewStyle.Selectable</i> .</p><small style="color: red"><small>Описание взято от [[FGX.CollectionView.TfgCustomCollectionView.OnSelectionChanged|OnSelectionChanged]].</small></small> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnCanItemSelect: [[TfgCanItemSelectEvent|TfgCanItemSelectEvent]]</code> | ||
+ | <p>Запрос разрешения на установку выделения элемента с индексом <i>AItemIndex</i> .</p><small style="color: red"><small>Описание взято от [[FGX.CollectionView.TfgCustomCollectionView.OnCanItemSelect|OnCanItemSelect]].</small></small> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnCanItemDeselect: [[TfgCanItemDeselectEvent|TfgCanItemDeselectEvent]]</code> | ||
+ | <p>Запрос разрешения на снятие выделения элемента с индексом <i>AItemIndex</i> .</p><small style="color: red"><small>Описание взято от [[FGX.CollectionView.TfgCustomCollectionView.OnCanItemDeselect|OnCanItemDeselect]].</small></small> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnItemSelectionChanged: [[TfgItemSelectionChangedEvent|TfgItemSelectionChangedEvent]]</code> | ||
+ | <p>Изменилось выделение у элемента с индексом <i>AItemIndex</i> .</p><small style="color: red"><small>Описание взято от [[FGX.CollectionView.TfgCustomCollectionView.OnItemSelectionChanged|OnItemSelectionChanged]].</small></small> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnScroll: [[TfgScrollEvent|TfgScrollEvent]]</code> | ||
+ | <p>Срабатывает, когда содержимое списка прокручивается.</p><small style="color: red"><small>Описание взято от [[FGX.CollectionView.TfgCustomCollectionView.OnScroll|OnScroll]].</small></small> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnPullToRefresh: [[TNotifyEvent]]</code> | ||
+ | <p>Срабатывает, когда пользователь запускает процесс обновления списка. Чтобы это событие работало, нужно обязательно включить поддержку режима обновления данных <i>EnabledPullToRefresh = True</i> .</p><small style="color: red"><small>Описание взято от [[FGX.CollectionView.TfgCustomCollectionView.OnPullToRefresh|OnPullToRefresh]].</small></small> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnMovingItem: [[TfgItemMovingEvent|TfgItemMovingEvent]]</code> | ||
+ | <p>Вызывается по ходу перемещения элемента списка. Позволяет запретить перемещение на позицию другого элемента. Чтобы запретить перемещение элемента на новую позицию, нужнео вернуть в параметре <i>AAllowed = False</i> .</p><small style="color: red"><small>Описание взято от [[FGX.CollectionView.TfgCustomCollectionView.OnMovingItem|OnMovingItem]].</small></small> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnMovedItem: [[TfgItemMovedEvent|TfgItemMovedEvent]]</code> | ||
+ | <p>Вызывается после того, как элемент перемещен на новую позицию списка.</p><small style="color: red"><small>Описание взято от [[FGX.CollectionView.TfgCustomCollectionView.OnMovedItem|OnMovedItem]].</small></small> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnDestroy: [[TNotifyEvent]]</code> | ||
+ | <p>Вызывается перед удалением контрола. А именно перед вызовом деструктора.</p><small style="color: red"><small>Описание взято от [[FGX.Controls.TfgControl.OnDestroy|OnDestroy]].</small></small> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnResized: [[TfgResizedEvent|TfgResizedEvent]]</code> | ||
+ | <p>Вызывается когда контрол изменил свой размерм.</p><small style="color: red"><small>Описание взято от [[FGX.Controls.TfgControl.OnResized|OnResized]].</small></small> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnLongTap: [[TfgLongTapEvent|TfgLongTapEvent]]</code> | ||
+ | <p>Срабатывает, когда пользователь долго нажимает на экран без перемещения пальца по экрану.</p><small style="color: red"><small>Описание взято от [[FGX.Controls.TfgControl.OnLongTap|OnLongTap]].</small></small> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnPositionChanged: [[TfgPositionChangedEvent|TfgPositionChangedEvent]]</code> | ||
+ | <p>Вызывается когда контрол поменял свою позицию.</p><small style="color: red"><small>Описание взято от [[FGX.Controls.TfgControl.OnPositionChanged|OnPositionChanged]].</small></small> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnTouch: [[TfgTouchEvent|TfgTouchEvent]]</code> | ||
+ | <p>Вызывается в момент касания пользователем экрана устройства.</p><small style="color: red"><small>Описание взято от [[FGX.Controls.TfgControl.OnTouch|OnTouch]].</small></small> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnTap: [[TNotifyEvent]]</code> | ||
+ | <p>Срабатывает, когда пользователь коротко нажимает на экран без перемещения пальца по экрану.</p><small style="color: red"><small>Описание взято от [[FGX.Controls.TfgControl.OnTap|OnTap]].</small></small> | ||
|} | |} |
Текущая версия на 17:16, 23 декабря 2022
Delphi
TfgCollectionView = class (TfgCustomCollectionView)
TComponent -> TfgControl -> TfgCustomCollectionView -> TfgCollectionView
Описание
Описание отсутствует.
Свойства
property
|
ColumnsCount: Integer
Количество столбцов, по которым размещаются элементы списка. Описание взято от ColumnsCount. |
property
|
DragOptions: TfgDragAndDropOptions
Настройки фунционала перетаскивания элементов между собой. Описание взято от DragOptions. |
property
|
PullToRefreshOptions: TfgPullToRefreshOptions
Настройки режима обновления списка "Потяни и обнови". Описание взято от PullToRefreshOptions. |
property
|
Padding: TfgPadding
Внутренние отступы, учитывающиеся при выравнивании элементов. Описание взято от Padding. |
property
|
ScrollGlowColor: TAlphaColor
Цвет эффекта прокручивания списка, который появляется при попытке прокрутить список за его границы. Актуально только для Андроид платформы. Описание взято от ScrollGlowColor.
|
property
|
ScrollGlowColorName: TfgAssetName
Описание отсутствует. |
property
|
SelectionOptions: TfgSelectionOptions
Настройки выделения. Описание взято от SelectionOptions. |
property
|
SelectionMode: TfgCollectionViewSelectionMode
Режим выделения элементов. Всего существует три способа выделения:
|
property
|
SelectionColor: TAlphaColor
Общий цвет выделение элементов по умолчанию. Каждый стиль элемента может переопределить это значение через аналогичное свойство TfgCollectionViewStyle.SelectionColor . Если указан цвет TAlphaColorRec.Null , то компонент будет использовать системный цвет для выделения, который зависит от платформы и версии ОС. Описание взято от SelectionColor.
|
property
|
SelectionColorName: TfgAssetName
Название ресурса цвета выделения элементов в контроле. Описание взято от SelectionColorName. |
property
|
HorzScrollBar: TfgScrollBarSettings
Настройки отображения горизонтальной полосы прокрутки. Описание взято от HorzScrollBar. |
property
|
VertScrollBar: TfgScrollBarSettings
Настройки отображения вертикальной полосы прокрутки. Описание взято от VertScrollBar. |
property
|
Alignment: TfgControlAlignment
Настройки выравнивания контрола в рамках родителя. Описание взято от Alignment. |
property
|
AlignWithMargins: Boolean
Нужно ли использовать заданные внешние отступы Margins . Описание взято от AlignWithMargins. |
property
|
BackgroundName: TfgAssetName
Настройки отображения заднего фона контрола. Описание взято от BackgroundName. |
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
|
OnGetItemCount: Integer
Через это событие компонент запрашивает общее количество элементов, которые необходимо отобразить. Компонент постоянно использует это событие для получения количества элементов. Поэтому избегайте практики долгого вычисления количества. Это может сказать на скорости прокрутки списка. Описание взято от OnGetItemCount.
|
event
|
OnGetItemId: TfgGetItemIdEvent
Через это событие компонент запрашивает уникальный идентификатор элемента. Эта информация может использоваться контролом для визуального выделения изменения элементов на экране при обновлении списка. По мимо этот идентификтор используется для корректного выделения элементов в случае, когда пользователь меняет данные элементов, добавляет или удаляет их. Обязательно должен быть уникальным среди идентификаторов всех элементов! Описание взято от OnGetItemId.
|
event
|
OnGetItemStyle: string
Через это событие компонент запрашивает название стиля, которое необходимо применить к элементу по указанному индексу. Компонент использует это событие в момент, когда указанный элемент готовится появится на экране. Обратите внимание, что если у вас в коллекции используется только один стиль, то это событие можно не использовать. Компонент автоматически выберет первый стиль, если вы не используете это событие. Описание взято от OnGetItemStyle.
|
event
|
OnBindItem: TfgBindItemEvent
Через это событие происходит связь пользовательских данных с конкретным элементом списка по указанному индексу. Все необходимые данные для отображения должны быть уже предварительно загружены и приготовлены к отображению. В этом событие необходимо связать готовые данные с конкретными контролами. Описание взято от OnBindItem.
|
event
|
OnTapItem: TfgItemTapEvent
Пользователь нажал на элемент списка. Описание взято от OnTapItem. |
event
|
OnLongTapItem: TfgItemLongTapEvent
Пользователь выполнил долгое нажатие на элемент списка. Данное событие работает автоматически. Не нужно отдельно включать значение LongTap в GestureKinds . Особенностью работы данного события - является события даже если долгое нажатие произведено на вложенный в элемент контрол, перехватывающий LongTap. Описание взято от OnLongTapItem.
|
event
|
OnUpdateItemSelectionAppearance: TfgUpdateItemSelectionAppearanceEvent
Необходимо вручную выполнить визуальное отображение/сброс выделение указаного элемента списка. Данное событие вызывается только при режиме SelectionOptions.PaintingMode = Manual . Описание взято от OnUpdateItemSelectionAppearance. |
event
|
OnSelectionChanged: TfgSelectionChangedEvent
Пользователь совершил выделение одного или нескольких элементов списка. За возможность выделения элемента отвечает свойство стиля TfgCollectionViewStyle.Selectable . Описание взято от OnSelectionChanged. |
event
|
OnCanItemSelect: TfgCanItemSelectEvent
Запрос разрешения на установку выделения элемента с индексом AItemIndex . Описание взято от OnCanItemSelect. |
event
|
OnCanItemDeselect: TfgCanItemDeselectEvent
Запрос разрешения на снятие выделения элемента с индексом AItemIndex . Описание взято от OnCanItemDeselect. |
event
|
OnItemSelectionChanged: TfgItemSelectionChangedEvent
Изменилось выделение у элемента с индексом AItemIndex . Описание взято от OnItemSelectionChanged. |
event
|
OnScroll: TfgScrollEvent
Срабатывает, когда содержимое списка прокручивается. Описание взято от OnScroll. |
event
|
OnPullToRefresh: TNotifyEvent
Срабатывает, когда пользователь запускает процесс обновления списка. Чтобы это событие работало, нужно обязательно включить поддержку режима обновления данных EnabledPullToRefresh = True . Описание взято от OnPullToRefresh. |
event
|
OnMovingItem: TfgItemMovingEvent
Вызывается по ходу перемещения элемента списка. Позволяет запретить перемещение на позицию другого элемента. Чтобы запретить перемещение элемента на новую позицию, нужнео вернуть в параметре AAllowed = False . Описание взято от OnMovingItem. |
event
|
OnMovedItem: TfgItemMovedEvent
Вызывается после того, как элемент перемещен на новую позицию списка. Описание взято от OnMovedItem. |
event
|
OnDestroy: TNotifyEvent
Вызывается перед удалением контрола. А именно перед вызовом деструктора. Описание взято от OnDestroy. |
event
|
OnResized: TfgResizedEvent
Вызывается когда контрол изменил свой размерм. Описание взято от OnResized. |
event
|
OnLongTap: TfgLongTapEvent
Срабатывает, когда пользователь долго нажимает на экран без перемещения пальца по экрану. Описание взято от OnLongTap. |
event
|
OnPositionChanged: TfgPositionChangedEvent
Вызывается когда контрол поменял свою позицию. Описание взято от OnPositionChanged. |
event
|
OnTouch: TfgTouchEvent
Вызывается в момент касания пользователем экрана устройства. Описание взято от OnTouch. |
event
|
OnTap: TNotifyEvent
Срабатывает, когда пользователь коротко нажимает на экран без перемещения пальца по экрану. Описание взято от OnTap. |