FMX.ImgList.TCustomImageList.AddOrSet
Delphi
function AddOrSet(const SourceName: string; const Scales: array of Single; const FileNames: array of string; const TransparentColor: TColor = TColors.SysNone; const Width: Integer = 0; const Height: Integer = 0): TImageIndex;
C++
System::Uitypes::TImageIndex __fastcall AddOrSet(const System::UnicodeString SourceName, const float *Scales, const int Scales_High, const System::UnicodeString *FileNames, const int FileNames_High, const System::Uitypes::TColor TransparentColor = (System::Uitypes::TColor)(0x1fffffff), const int Width = 0x0, const int Height = 0x0);
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| function | public | FMX.ImgList.pas FMX.ImgList.hpp |
FMX.ImgList | TCustomImageList |
Beschreibung
Die FMX-ImageList setzt die einzelnen Bilder (auch Destination genannt) aus sogenannten Bildquellen (Source) zusammen. Eine Bildquelle wiederum ist eine Gruppe von Einzelbildern in verschiedenen Größen, die unter einem Namen (SourceName) abgelegt wird. Jedes Einzelbild dieser Bildquelle wird durch einen Faktor (Scale) und einen Dateinamen (FileName) gekennzeichnet.
Ist der bei AddOrSet angegebene SourceName bereits vorhanden, wird die entsprechende Bildquelle ersetzt und in den Destinations alle Referenzen darauf aktualisiert. Ist der SourceName neu, wird aus den Parametern Scales und FileNames eine neue Bildquelle erzeugt. Die Arrays Scales und FileNames müssen gleich lang sein.
TransparentColor gibt, wie der Name vermuten lässt, die Farbe an, die als transparent angenommen wird. Per Default ist das <keine>, womit das Bild einfach übernommen wird, wie es ist.
Width und Height geben die Nenngröße der Bildquelle an, die der Größe bei Scale = 1 entspricht. Sind Width und Height beide 0 wird die Größe des ersten Bildes (FileNames[0]) verwendet und mit dem Scales[0]-Faktor verrechnet.
Wenn ein vorhandener SourceName übergeben, ist der Rückgabewert der Funktion = 0. Andernfalls wird eine neue Destination angelegt, die ausschließlich die neu angelegte Bildquelle enthält, und der neue Index zurückgegeben.