FMX.ListView.Appearances.TCommonObjectAppearance
Delphi
TCommonObjectAppearance = class(TObjectAppearance, IMovablePersistent)
C++
class PASCALIMPLEMENTATION TCommonObjectAppearance : public TObjectAppearance
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| class | public | FMX.ListView.Appearances.pas FMX.ListView.Appearances.hpp |
FMX.ListView.Appearances | FMX.ListView.Appearances |
Beschreibung
Inhaltsverzeichnis
Basisklasse, die zusätzlich zu TObjectAppearance Funktionen zum vereinfachten Erstellen neuer Objekterscheinungsbild-Typen bereitstellt.
Die folgende Liste enthält die integrierten Objekterscheinungsbildklassen, die Unterklassen von TCommonObjectAppearance erzeugen:
- TAccessoryObjectAppearance
- TGlyphButtonObjectAppearance
- TImageObjectAppearance
- TTextButtonObjectAppearance
- TTextObjectAppearance
Verwenden einer Unterklasse von TCommonObjectAppearance
Ein Objekterscheinungsbild muss über einen Eigentümer und einen Namen verfügen, der das Objekterscheinungsbild eindeutig unter den Objekterscheinungsbildern seines Eigentümers identifiziert.
Um Eigenschaften eines Objekterscheinungsbildes, die sich auf dessen Darstellung auswirken, zu ändern, führen Sie die Änderungen zwischen einem Aufruf von BeginUpdate und einem Aufruf von EndUpdate durch.
TCommonObjectAppearance stellt zum Anpassen des Objekterscheinungsbildes die folgenden Eigenschaften bereit:
- Align und VertAlign
- Opacity
- PlaceOffset (auch ActualPlaceOffset und InternalPlaceOffset)
- Width (auch ActualWidth, WidthWhenVisible und InternalWidth) und Height (auch ActualHeight, HeightWhenVisible und InternalHeight)
- Visible
Die folgende Tabelle enthält die Zuordnung von Eigenschaften von TCommonObjectAppearance zu Eigenschaften von TListItemDrawable:
| Eigenschaft TCommonObjectAppearance | Zugehörige Eigenschaft TListItemDrawable |
|---|---|
| ActualPlaceOffset | PlaceOffset |
| Align | Align |
| Opacity | Opacity |
| SizeWhenVisible | Size |
| VertAlign | VertAlign |
| Visible | Visible |
In Unterklassen können weitere Eigenschaften definiert werden, die sich auf das Erscheinungsbild auswirken und Eigenschaften von TListItemDrawable-Unterklassen zugeordnet werden können.
Mit einer Behandlungsroutine für das Ereignis OnChange können Sie reagieren, wenn sich eine dieser Eigenschaften ändert, und mit einer Behandlungsroutine für das Ereignis OnHeightChange, wenn sich Height ändert.
Sie können die Standardwerte von Eigenschaften, die sich auf das Erscheinungsbild auswirken, jederzeit wiederherstellen.
Ableiten von TCommonObjectAppearance-Unterklassen
Um einen benutzerdefinierten Objekterscheinungsbildtyp zu definieren, erstellen Sie eine Unterklasse von TCommonObjectAppearance, und gehen dann folgendermaßen vor:
- Überschreiben Sie AssignTo, um die Kopierunterstützung zu implementieren.
- Überschreiben Sie
CreateDefaultValues, um einen gültigen Wert für DefaultValues zurückzugeben (einen Wert, der durch Übergabe vonAIsDefaultValuesmitTruean den Konstruktor erstellt wurde). - Überschreiben Sie CreateObject, um eine Instanz einer Unterklasse von TListItemDrawable zu erstellen, und füllen Sie sie zwischen einem Aufruf von TListItemDrawable.BeginUpdate und einem Aufruf von TListItemDrawable.EndUpdate mit den relevanten Eigenschaften des Objekterscheinungsbildes. Sie können beim Implementieren der Instanz AssignTo zur Unterstützung der Unterklasse von TListItemDrawable, die CreateObject als Parameter zurückgibt, verwenden.
- Überschreiben Sie ResetObject. Sie können für die Implementierung ResetObjectT verwenden.
Anschließend sollten Sie alle weiteren Eigenschaften hinzufügen, die für das Objekterscheinungsbild erforderlich sind.
Objekterscheinungsbildtypen werden selten allein implementiert. Normalerweise implementieren Sie zuerst eine TListItemDrawable-Unterklasse und dann einen entsprechenden Objekterscheinungsbildtyp.