FGX.CollectionView.TfgCustomCollectionView: различия между версиями
Admin (обсуждение | вклад) (summary) |
Admin (обсуждение | вклад) (summary) |
||
Строка 13: | Строка 13: | ||
| <code>constructor</code> || <code>Create(AOwner: TComponent)</code> | | <code>constructor</code> || <code>Create(AOwner: TComponent)</code> | ||
+ | |} | ||
+ | |||
+ | == Методы == | ||
+ | |||
+ | {| class="wikitable sortable" | ||
+ | |- | ||
+ | | <code>procedure</code> || <code>ReloadItems()</code> | ||
+ | Перезагружает элементы коллекции. Форсирует перезагрузку всех элементов списка. | ||
+ | |- | ||
+ | | <code>procedure</code> || <code>ReloadItem(const AItemIndex: Integer)</code> | ||
+ | Перезагружает элемент коллекции по указанному индексу. | ||
+ | |- | ||
+ | | <code>function</code> || <code>GetItemId(const AItemIndex: Integer)</code> | ||
+ | Возвращает идентификатор элемента по его порядковому индексу. Для этого использует данные, полученные в результате работы обработчика события '' OnGetItemId '' . По умолчанию использует порядковый иднекс элемента. | ||
+ | |- | ||
+ | | <code>function</code> || <code>FindItemIndexById(const AItemId: Int64, out AItemIndex: Integer)</code> | ||
+ | Поиск порядкового индекса элемента по его уникальному идентификатору. Задание уникальных идентификаторо элементов осуществляется через событие '' OnGetItemId '' . | ||
+ | |- | ||
+ | | <code>function</code> || <code>FindItemIndexByPoint(const APoint: TPointF, out AItemIndex: Integer)</code> | ||
+ | Поиск порядкового индекса элемента по координатам точки в CollectionView, попадающая в один из видимых элементов. Работает только для видимых элементов с индексами в диапазоне '' GetFirstVisibleItemIndex '' и '' GetLastVisibleItemIndex '' . '' APoint '' указывается в системе координат контрола с учетом смещения прокрутки. | ||
+ | |- | ||
+ | | <code>function</code> || <code>FindItemIndexByObject(const AObject: TObject, out AItemIndex: Integer)</code> | ||
+ | Поиск порядкового индекса элемента по объекту, который принадлежит стилю элемента (по цепочке родителей можно выйти к стилю элемента). | ||
+ | |- | ||
+ | | <code>function</code> || <code>FindItemWrapperByIndex(const AItemIndex: Integer, out AItemWrapper: TfgItemWrapper)</code> | ||
+ | Ищет '' TfgItemWrapper '' для работы с контролом элемента по индексу. Если элемента по указанному индексу нет, то в '' AItemWrapper '' будет nil. | ||
+ | |- | ||
+ | | <code>function</code> || <code>FindItemControlByIndex(const AItemIndex: Integer, out AControl: TfgControl)</code> | ||
+ | Ищет контрол '' TfgControl '' элемента по индексу. Если элемента по указанному индексу нет, то в '' AControl '' будет nil. | ||
+ | |- | ||
+ | | <code>function</code> || <code>GetFirstVisibleItemIndex()</code> | ||
+ | Возвращает индекс первого видимого элемента на экране. | ||
+ | |- | ||
+ | | <code>function</code> || <code>GetLastVisibleItemIndex()</code> | ||
+ | Возвращает индекс последнего видимого элемента на экране. | ||
+ | |- | ||
+ | | <code>function</code> || <code>CreateStyle()</code> | ||
+ | Создает новый пустой стиль с уникальным именем '' TfgCollectionViewStyle.TfgStyleName '' . | ||
+ | |- | ||
+ | | <code>procedure</code> || <code>AddStyle(const AStyle: TfgCollectionViewStyle)</code> | ||
+ | Добавляет стиль в список стилей контрола. | ||
+ | |- | ||
+ | | <code>function</code> || <code>GetStyle(const AStyleName: string)</code> | ||
+ | Возвращает стиль по его имени. | ||
+ | |- | ||
+ | | <code>function</code> || <code>GetStyleIndex(const AStyleName: string)</code> | ||
+ | Возвращает индекс стиля по его имени. Первый стиль имеет индекс 0. | ||
+ | |- | ||
+ | | <code>function</code> || <code>GetStyleForItemIndex(const AItemIndex: Integer)</code> | ||
+ | Возвращает стиль элемента по указанному индексу элемента. | ||
+ | |- | ||
+ | | <code>procedure</code> || <code>ScrollToItem(const AItemIndex: Integer, const AWithAnimation: Boolean)</code> | ||
+ | |||
+ | |- | ||
+ | | <code>procedure</code> || <code>ResetSelection()</code> | ||
+ | Сбрасывает текущее выделение всех выделенных элементов. | ||
+ | |- | ||
+ | | <code>procedure</code> || <code>ResetSelection(const AItemIndex: Integer)</code> | ||
+ | Сбрасывает текущее выделение элемента с указанным индексом. | ||
+ | |- | ||
+ | | <code>procedure</code> || <code>SelectItem(const AItemIndex: Integer)</code> | ||
+ | Выделяет элемент с указанным индексом. | ||
+ | |- | ||
+ | | <code>procedure</code> || <code>SelectAllItems()</code> | ||
+ | Выделяет все элементы списка. | ||
+ | |- | ||
+ | | <code>procedure</code> || <code>BeginPullToRefresh()</code> | ||
+ | Запускает программным способом процесс обновления данных с одновременным отображением индикатора загрузки. Разработчик должен выполнить/запустить процесс обновления данных и по окончании загрузки данных сообщить об этом контролу, вызвав '' EndPullToRefresh '' . Обратите внимание, что для визуального обновления данных, разработчику так же нужно воспользовать одним из методов обновления данных '' ReloadItems '' или '' ReloadItem '' . | ||
+ | |- | ||
+ | | <code>procedure</code> || <code>EndPullToRefresh()</code> | ||
+ | Заканчивает процесс обновления данных, начатый пользователем. Это приводит к скрытию индикатора загрузки и загрузки данных в список. Обратите внимание, что для визуального обновления данных, разработчику так же нужно воспользовать одним из методов обновления данных '' ReloadItems '' или '' ReloadItem '' . | ||
|} | |} |
Версия 23:50, 9 июня 2019
Delphi
TfgCustomCollectionView = class (TfgControl, IFGXTapSupported, IFGXNotificationObserver, IFGXNotificationObservable)
Конструкторы
constructor |
Create(AOwner: TComponent)
|
Методы
procedure |
ReloadItems()
Перезагружает элементы коллекции. Форсирует перезагрузку всех элементов списка. |
procedure |
ReloadItem(const AItemIndex: Integer)
Перезагружает элемент коллекции по указанному индексу. |
function |
GetItemId(const AItemIndex: Integer)
Возвращает идентификатор элемента по его порядковому индексу. Для этого использует данные, полученные в результате работы обработчика события OnGetItemId . По умолчанию использует порядковый иднекс элемента. |
function |
FindItemIndexById(const AItemId: Int64, out AItemIndex: Integer)
Поиск порядкового индекса элемента по его уникальному идентификатору. Задание уникальных идентификаторо элементов осуществляется через событие OnGetItemId . |
function |
FindItemIndexByPoint(const APoint: TPointF, out AItemIndex: Integer)
Поиск порядкового индекса элемента по координатам точки в CollectionView, попадающая в один из видимых элементов. Работает только для видимых элементов с индексами в диапазоне GetFirstVisibleItemIndex и GetLastVisibleItemIndex . APoint указывается в системе координат контрола с учетом смещения прокрутки. |
function |
FindItemIndexByObject(const AObject: TObject, out AItemIndex: Integer)
Поиск порядкового индекса элемента по объекту, который принадлежит стилю элемента (по цепочке родителей можно выйти к стилю элемента). |
function |
FindItemWrapperByIndex(const AItemIndex: Integer, out AItemWrapper: TfgItemWrapper)
Ищет TfgItemWrapper для работы с контролом элемента по индексу. Если элемента по указанному индексу нет, то в AItemWrapper будет nil. |
function |
FindItemControlByIndex(const AItemIndex: Integer, out AControl: TfgControl)
Ищет контрол TfgControl элемента по индексу. Если элемента по указанному индексу нет, то в AControl будет nil. |
function |
GetFirstVisibleItemIndex()
Возвращает индекс первого видимого элемента на экране. |
function |
GetLastVisibleItemIndex()
Возвращает индекс последнего видимого элемента на экране. |
function |
CreateStyle()
Создает новый пустой стиль с уникальным именем TfgCollectionViewStyle.TfgStyleName . |
procedure |
AddStyle(const AStyle: TfgCollectionViewStyle)
Добавляет стиль в список стилей контрола. |
function |
GetStyle(const AStyleName: string)
Возвращает стиль по его имени. |
function |
GetStyleIndex(const AStyleName: string)
Возвращает индекс стиля по его имени. Первый стиль имеет индекс 0. |
function |
GetStyleForItemIndex(const AItemIndex: Integer)
Возвращает стиль элемента по указанному индексу элемента. |
procedure |
ScrollToItem(const AItemIndex: Integer, const AWithAnimation: Boolean)
|
procedure |
ResetSelection()
Сбрасывает текущее выделение всех выделенных элементов. |
procedure |
ResetSelection(const AItemIndex: Integer)
Сбрасывает текущее выделение элемента с указанным индексом. |
procedure |
SelectItem(const AItemIndex: Integer)
Выделяет элемент с указанным индексом. |
procedure |
SelectAllItems()
Выделяет все элементы списка. |
procedure |
BeginPullToRefresh()
Запускает программным способом процесс обновления данных с одновременным отображением индикатора загрузки. Разработчик должен выполнить/запустить процесс обновления данных и по окончании загрузки данных сообщить об этом контролу, вызвав EndPullToRefresh . Обратите внимание, что для визуального обновления данных, разработчику так же нужно воспользовать одним из методов обновления данных ReloadItems или ReloadItem . |
procedure |
EndPullToRefresh()
Заканчивает процесс обновления данных, начатый пользователем. Это приводит к скрытию индикатора загрузки и загрузки данных в список. Обратите внимание, что для визуального обновления данных, разработчику так же нужно воспользовать одним из методов обновления данных ReloadItems или ReloadItem . |