TCustomImageList.AddOrSet Parameter

[Uwe Raabe]

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.