Refactoring des Listenansichts-Steuerelements in Seattle

Nach oben zu Neuerungen in Seattle

Die API der Listenansicht von RAD Studio Seattle wurde umgestaltet. Die Listenansichts- und Listenansichtseintrags-Komponenten wurden in verschiedene Ebenen aufgeteilt, um eine flexiblere Listenansichts-API bereitzustellen, die einfacher erweiterbar ist als in XE8.

Diese Änderungen sollten sich kaum auf Projekte auswirken, die einfach die TListView-Komponente verwenden. Diese Änderungen können jedoch merklichen Einfluss auf Projekte haben, in denen Unterklassen von Listenansichts- oder Listenansichtseintrags-Klassen abgeleitet werden.

TCustomListView wurde in fünf Klassen aufgeteilt

TCustomListView wurde in die folgenden Klassen aufgeteilt, die voneinander erben:

• TAdapterListView
• TListViewBase
• TPresentedListView
• TAppearanceListView
• TCustomListView

Als Folge dieser Umgestaltung wurden viele Member aus TCustomListView entfernt und den neuen Listenansichts-Klassen neue Member hinzugefügt:

Klasse oder Unit	Member von TCustomListView	Neue Member
FMX.ListView.TAdapterListView	Protected: DoItemsChange InvalidateHeights	Public: Adapter Protected: DoAdapterSet DoItemsCouldHaveChanged DoItemsInvalidate DoItemsMayChange DoItemsResize DoResetView HeightSumsNeedUpdate SetAdapter
FMX.ListView.TListViewBase	Public: AllowSelection AlternatingColors AutoTapScroll AutoTapTreshold CanSwipeDelete ControlType DeleteButtonText DisableMouseWheel EditMode GetItemRect Images ItemCount ItemIndex ItemSpaces NativeOptions OnChangeRepainted OnChange OnDeleteChangeVisible OnDeleteItem OnDeletingItem OnFilter OnItemChange OnItemClickEx OnItemsChange OnPullRefresh OnScrollViewChange OnSearchChange PullRefreshWait PullToRefresh RebuildList ScrollTo ScrollViewPos SearchAlwaysOnTop SearchVisible Selected SelectionCrossfade ShowSelection SideSpace StopPullRefresh TDeleteChangeVisibilityEvent TDeleteItemEvent TDeletingItemEvent THandleChangeEvent TListItemClickEventEx (früher TItemClickEventEx) Transparent Protected: DoChangeRepainted DoChange DoEditModeChange DoEditModeChanging DoListItemChange (früher DoItemChange) DoListItemClick (früher DoItemClick) GetFinalItemSpaces GetStyleResources ImagesChanged InitDeleteModeAnimation InitEditModeAnimation Invalidate OnEditModeChange OnEditModeChanging ProceedDeleteItem ResetDeleteModeAnimation ResetEditModeAnimation ScrollStretchChanged ScrollStretchStrength SetItemSpaces UpdateDeleteButtonLayout	Public: GetDefaultMargins OnListItemClick TListItemEvent TUpdateItemViewEvent TUpdatingItemViewEvent Protected: DeleteItem DoDeleteItem DoResetEditModeAnimation DoSetItemIndexInternal DoSetScrollViewPos DoUpdateItemView DoUpdateScrollViewPos DoUpdatingItemView FeedbackItemClickChecked GetClientMargins GetDeleteButtonText GetDeleteModeTransitionAlpha GetEditModeTransitionAlpha GetFinalItemSize GetImageIndex GetImageList GetImages GetItemClientRect GetItemCurrentSelectionAlpha GetItemDeleteCutoff GetItemEditOffset HasButtonsInCells HasCheckboxMode HasDeletionEditMode IsEditMode ObserversBeforeSelection OnUpdateItemView OnUpdatingItemView SetControlType SetDeleteButtonIndex SetDeleteButtonText SetImageIndex SetImageList SetImages SetNativeOptions SetPullToRefresh SetSelectionCrossfade ShouldHandleEvents StyleResourcesNeedUpdate UsesNativePresentation WillEnterEditMode
FMX.ListView.TPresentedListView		Protected: CanSelectItem CanUnselectItem DidSelectItem DidUnselectItem ExecuteInterlocked GetAdapter GetControlOpacity GetItemIndexTitle GetItemText GetTableViewFlags GetTableViewOptions InvokePullRefresh ItemButtonClicked PMAncesstorPresentationLoaded SetSearchFilter
FMX.ListView.TAppearanceListView	Public: Items OnItemClick OnUpdateObjects OnUpdatingObjects TItemEvent TUpdatingObjectsEvent Protected: DoButtonChange DoButtonClick EditModeAppearances FooterAppearanceClassName FooterAppearanceName FooterHeight GetAppearanceProperties HeaderAppearanceClassName HeaderAppearanceName HeaderHeight InitializeItemAppearance ItemAppearanceChangeHeight ItemAppearanceChangeObjects ItemAppearanceChange ItemAppearanceClassName ItemAppearanceName ItemAppearanceObjects ItemAppearance ItemEditAppearanceClassName ItemEditAppearanceName ItemEditHeight ItemHeight OnButtonChange OnButtonClick PrepareEditModeObjects RefreshAppearances UpdateAppearanceStyleResources	Protected: GetAppearanceListViewItem GetFooterHeight GetHeaderHeight GetItemEditHeight GetItemHeight ObjectsNotify SetFooterHeight SetHeaderHeight SetItemEditHeight SetItemHeight
FMX.ListView.Appearances	Protected: TAppearanceNamePair TAppearanceNames TAppearanceType TItemAppearanceObjectsClass TItemControlEvent TPublishedAppearance TPublishedObjects TRegisterAppearanceOptions TRegisterAppearanceOption TRegisteredAppearance
FMX.ListView.Appearances.TAppearancesRegistry	Protected: cRegisterAll cRegisterDefault GetRegisteredAppearances RegisterAppearances RegisterAppearance UnregisterAppearances UnregisterAppearance
FMX.ListView.Types	Protected: TListItemPurposes

Außerdem:

• Es wurden zwei neue Interfaces erstellt, IAppearanceItemOwner und IPublishedAppearanceOwner, die TAppearanceListView implementiert.
• Durch die neue Implementierung der Prozedur Resize wurden die Prozeduren ResizeAppearances und ResizeObjects überflüssig und daher entfernt.
• BeginAppearanceUpdate und EndAppearanceUpdate wurden jeweils durch BeginUpdate und EndUpdate ersetzt.

TListViewItems wurde in vier Klassen aufgeteilt

TListViewItems wurde in eine neue Unit, FMX.ListView.Adapters.Base, verschoben und in die folgenden Klassen aufgeteilt, die voneinander erben:

• TAbstractListViewAdapter
• TListViewItems
• TFilterableListViewItems
• TAppearanceListViewItems

Als Folge dieser Umgestaltung wurden die folgenden Member aus TListViewItems entfernt:

Klasse oder Unit	Member von TListViewItems	Neue Member
TAbstractListViewAdapter	Public: Sort (Früher protected)	Public: Changed ItemsCouldHaveChanged ItemsInvalidate ItemsMayChange ItemsResize OnChanged OnItemsCouldHaveChanged OnItemsInvalidate OnItemsMayChange OnItemsResize OnResetView Protected: CreateNewViews DoCreateNewViews DoResetViews DoResetView DoSort ResetViews ResetView SetOnChanged SetOnItemsCouldHaveChanged SetOnItemsInvalidate SetOnItemsMayChange SetOnItemsResize SetOnResetView
TFilterableListViewItems	Public: Filter Filtered UnfilteredItems	Protected: DoFilterItem
TAppearanceListViewItems	Public: Add AnyChecked CheckAll CheckedCount CheckedIndexes Clear Delete FirstChecked Insert Protected: AddItem AppearanceItem AsFilterable Checked GetChecked GetEnumerator SetChecked SetOnCheckChange SyncCheckedState	Protected: AppearanceItemOwner CheckChange GetAppearanceItem OwnerControl PrepareEditModeObjects ReindexAndFindItem
FMX.ListView.Types	TListItemsList (früher TItemsList) TFilterPredicate

Aufgrund dieser Umgestaltung wurden die folgenden neuen Interfaces erstellt, die diese Listeneintrags-Klassen implementieren:

Klasse	Interfaces
TListViewItems	IListViewAdapter
TFilterableListViewItems	IListViewFilterable
TAppearanceListViewItems	IListViewCheckProvider IListViewEditor IListViewExtrasProvider IListViewGlyphButtonProvider IListViewTextButtonProvider IListViewTextProvider

Klassen für das Objekterscheinungsbild nach FMX.ListView.Appearances verschoben

Die folgenden Klassen wurden in die Unit FMX.ListView.Appearances verschoben:

• TAccessoryObjectAppearance
• TAppearanceObjects
• TCommonObjectAppearance
• TCustomAccessoryObjectAppearance
• TCustomGlyphButtonObjectAppearance
• TCustomImageObjectAppearance
• TCustomItemObjects
• TCustomTextButtonObjectAppearance
• TCustomTextObjectAppearance
• TEmptyItemObjects
• TGlyphButtonObjectAppearance
• TImageObjectAppearance
• TItemAppearanceObjects
• TItemAppearanceProperties
• TNullItemObjects
• TObjectAppearance
• TPresetItemObjects
• TTextButtonObjectAppearance
• TTextObjectAppearance

TListItemObject wurde umbenannt und geändert

TListItemObject wurde in TListItemDrawable umbenannt und ist jetzt nur noch aus Gründen der Abwärtskompatibilität als leere Unterklasse von TListItemDrawable vorhanden.

Zusätzlich wurden die folgenden Änderungen an TListItemDrawable vorgenommen:

• Das Feld FLocalRect wurde zur Eigenschaft LocalRect.
• Es wurde eine neue Funktion, InLocalRect, hinzugefügt.
• Die Sichtbarkeit von CalculateLocalRect wurde von protected in public geändert.

TListItemObjectClass wurde nach FMX.ListView.Appearances verschoben und ist jetzt eine Klassenreferenz von TListItemDrawable.

TListItemObjects wurde in TListItemView umbenannt und ist jetzt nur noch aus Gründen der Abwärtskompatibilität als leere Unterklasse von TListItemView vorhanden.

Zusätzlich wurden die folgenden Änderungen an TListItemView vorgenommen:

• Die Eigenschaft ItemList wurde in ViewList umbenannt. Und deren Sichtbarkeit von protected in public geändert.
• Die Eigenschaft Objects wurde in Drawables umbenannt.
• Die Funktion FindObject ist jetzt veraltet, verwenden Sie stattdessen die neue Funktion FindDrawable.
• Die Funktion ObjectByName ist jetzt veraltet, verwenden Sie stattdessen die neue Funktion DrawableByName.
• Es wurde eine neue Prozedur, Insert, hinzugefügt.

TListItem wurde geändert

In TListItem:

• Zwei neue Eigenschaften: Adapter, Index.
• Die protected FHeaderRef-Felder wurden durch die public Eigenschaft HeaderRef ersetzt.
• Der Typ TListItemObjectsType wurde in TListItemViewType umbenannt.
• Die Eigenschaft Objects wurde in View umbenannt.
• Mit dem Feld FParent können Sie nicht mehr auf das übergeordnete Steuerelement der Eintragsliste zugreifen, die Sie an den Konstruktor übergeben haben.

Weitere Änderungen

• Die Prozedur TCustomListView.ClearItems, die bereits in XE8 veraltet war, wurde entfernt. Verwenden Sie stattdessen TCustomListView.Items.Clear.
• Appearances.TListViewItem wurde nach FMX.ListView.Appearances verschoben, und es gibt in FMX.ListView.Appearances einen neuen Alias dafür: TAppearanceListViewItem.
• Die Klasse TListItemImage stellt eine neue Prozedur bereit: FitInto.
• Das Interface IListItemStyleResources definiert eine neue Funktion: StyleResourcesNeedUpdate.
• Das Interface IListViewPresentationParent definiert die folgenden neuen Methoden: GetAdapter, GetItemClientRect, RebuildList. Außerdem gibt DeleteItem jetzt einen booleschen Wert zurück, der angibt, ob die Löschung erfolgreich war oder nicht.
• Neuer Typ, TListItemsList, der ein Alias von TList<TListItem> ist.
• TAppearancesRegistry, eine neue Klasse, die Member enthält, die aus TCustomListView übernommen wurden, stellt eine weitere neue Funktion bereit: FindItemAppearanceObjectsClassByOption.
• Die Sichtbarkeit der Eigenschaft Owner von TPublishedAppearance wurde von public in published geändert.
• Die Eigenschaft Owner von TPublishedObjects ist nicht mehr verfügbar.