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

Материал из FGX Native Докуметации
Перейти к навигации Перейти к поиску
(summary)
(summary)
 
Строка 46: Строка 46:
 
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Id: [[Int64]]</code>
 
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Id: [[Int64]]</code>
  
<p>Уникальный идентификатор элемента. Используется для корректного выделения элемента, при изменении списка элементов (удалении, изменении или добавлении новых).</p><div class="info">По умолчанию совпадает с индексом. Если вы планируете обновлять список одновременно с работой выделения, то необходимо каждому элементу присвоить постоянный не изменяемый идентификатор через событие <i>TfgCOllectionItem.OnGetItemId</i></div>
+
<p>Уникальный идентификатор элемента. Используется для корректного выделения элемента, при изменении списка элементов (удалении, изменении или добавлении новых).</p><div class="info">По умолчанию совпадает с индексом. Если вы планируете обновлять список одновременно с работой выделения, то необходимо каждому элементу присвоить постоянный не изменяемый идентификатор через событие <i>TfgCollectionView.OnGetItemId</i></div>
 
|-
 
|-
 
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>StyleName: [[string]]</code>
 
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>StyleName: [[string]]</code>

Текущая версия на 03:16, 6 декабря 2021

Delphi

TfgItemWrapper = class (TObject)

TObject -> TfgItemWrapper

Описание

Обертка для доступа к контролам одного элемента коллекции. Обеспечивает вспомогательные методы для быстрого поиска вложенных контролов по имени TfgControl.LookupName с кешированием.

Конструкторы

constructor
Create(const AItem: TfgCollectionViewStyle; const AData: IFGXItemDataAccessor)

Описание отсутствует.

Методы

procedure
UpdateLookupNameIndex()

Обновляет индекс, используемый для быстрого доступа к компонентам стиля через LookupName .

TfgItemWrapper формирует индекс только при создании, тем самым обеспечивая быструю работу метода GetControlByLookupName . Однако, кеш не обновляется автоматически при динамических изменениях структуры стиля при связывании данных. И в этом случае, если требуется, можно вызвать этот метод.
function
GetControlByLookupName(const ALookupName: string): T

Доступ к конкретному вложенному контролу элемента по имени TfgControl.LookupName с приведением к указанному классу T .

Если контрола с указанным именем поиска нету, то вернет nil. Если элемент с указанным именем есть, но он не подходяшего класса, то так же вернет nil.
function
GetControlByName(const AName: string): T

Доступ к конкретному вложенному контролу элемента по имени TfgControl.Name с приведением к указанному классу T .

Если контрола с указанным именем поиска нету, то вернет nil. Если элемент с указанным именем есть, но он не подходяшего класса, то так же вернет nil.

Свойства

property
Index: Integer

Порядковый индекс элемента в списке.

При удалении из списка элемента до текущего этот индекс поменяет свое значение. Если вам важно однозначно идентифицировать элемент в биндинге, то используйте свойство Id для задания уникального идентификатора элементу.
property
Id: Int64

Уникальный идентификатор элемента. Используется для корректного выделения элемента, при изменении списка элементов (удалении, изменении или добавлении новых).

По умолчанию совпадает с индексом. Если вы планируете обновлять список одновременно с работой выделения, то необходимо каждому элементу присвоить постоянный не изменяемый идентификатор через событие TfgCollectionView.OnGetItemId
property
StyleName: string

Название использованного стиля элемента.

property
Controls[const ALookupName]: TfgControl

Доступ к конкретному вложенному контролу элемента по имени TfgControl.LookupName и TfgControl.Name .

Если контрола с указанным именем поиска нету, то вернет nil.
property
Item: TfgCollectionViewStyle

Возвращает контрол, представляющий корень элемента коллекции.