Bezeichnung
idx = AddIconImage -- fügt ein Bild zum Piktogramm hinzu (V8.0)
Übersicht
AddIconImage(id, table)
Beschreibung
Mit diesem Befehl können Sie dem mit id angegebenen Piktogramm ein neues Bild hinzufügen. Das Bild muss im Parameter table angegeben werden, der auf eine Tabelle gesetzt werden muss, die die folgenden Felder verwendet:

Type:
Mit diesem Tag können Sie den Quelltyp des Bildes festlegen, das Sie zum Piktogramm hinzufügen möchten. Dies kann #BRUSH sein, wenn Sie einen Pinsel hinzufügen wollen oder #FILE, wenn Sie ein Bild aus einer externen Dateiquelle hinzufügen möchten. Der Standardwert ist #BRUSH. Beachten Sie, dass sich diese Standardeinstellung von der Standardeinstellung der Präprozessor-Anweisung @ICON unterscheidet. Da ist #FILE voreingestellt.

Image:
Dieser Tag gibt die tatsächliche Bildquelle an und muss festgelegt werden. Wenn Type auf #BRUSH gesetzt wurde, müssen Sie diesen Tag auf den Identifikator eines Pinsels setzen, den Sie zum Piktogramm hinzufügen möchten. Andernfalls muss Image auf den Pfad einer Bilddatei gesetzt werden. Die Bilddatei kann in einem der von Hollywood unterstützten Bilddateiformate sein. Wenn die hier angegebene Bilddatei einen Alphakanal aufweist, werden die Alphakanaldaten automatisch geladen. Beachten Sie auch, dass in jedem Piktogramm jede Bildgröße nur einmal verwendet werden kann, d.h. es ist nicht möglich, zwei 48x48-Bilder zu einem einzelnen Piktogramm hinzuzufügen. Beachten Sie auch, dass es nicht möglich ist, einem Piktogramm ein Vektorgrafikbild hinzuzufügen, da Vektorpiktogramme nur ein einzelnes Bild enthalten dürfen. Siehe CreateIcon für Details.

SelImage:
Mit diesem Tag können Sie ein zusätzliches Bild einfügen, das als ausgewählte Version des in Image angegebenen Bildes verwendet werden soll. Dieser Tag ist optional. Wenn Sie ihn einstellen, muss das hier angegebene Bild genau dieselbe Größe wie das in Image angegebene haben. Darüber hinaus wird SelImage auf die gleiche Weise wie Image verwendet, d.h. es hängt von dem in Type eingestellten Bildtyp ab, was Sie hier übergeben müssen. Entweder ist dies ein Pinselidentifikator oder einen Pfad zu einer externen Bilddatei.

Standard:
Mit diesem Tag können Sie das Bild festlegen, das als Standardgröße für das Piktogramm hinzugefügt werden soll. Das Festlegen einer Standardgröße ist in manchen Kontexten wichtig, damit Hollywood weiß, welches Bild für höhere Auflösungen ausgewählt werden soll, z.B. wenn Sie ein 64x64-Bild in einem Piktogramm als Standardgröße festlegen, wählt Hollywood das Bild mit 128x128 aus, falls die Auflösung des Monitors eine DPI-Einstellung verwendet, die doppelt so hoch ist wie die normale Einstellung. Natürlich kann in jedem Piktogramm nur ein Standardbild vorhanden sein. Wenn also bereits ein Standardbild im Piktogramm vorhanden ist, wird ein Fehler generiert.

AddIconImage() gibt den Index zurück, an dem das Bild innerhalb des Piktogramm hinzugefügt wurde. Beachten Sie, dass dies nicht unbedingt der letzte Index im Piktogramm ist, da die einzelnen Bilder in Piktogrammen nach ihrer Breite in aufsteigender Reihenfolge sortiert werden. Die von AddIconImage() zurückgegebenen Indizes beginnen bei 1.

Um ein Bild von einem Piktogramm zu entfernen, verwenden Sie den Befehl RemoveIconImage().

Eingaben
id
Identifikator des zu verwendenden Piktogramms
table
Tabelle zur Beschreibung des Bildes, das dem Piktogramm hinzugefügt werden soll (siehe oben)
Rückgabewerte
idx
Index, an dem das Bild hinzugefügt wurde (beginnend bei 1)
Beispiel
AddIconImage(1, {Image = "ic16x16.png"})
Der obige Code fügt die Bilddatei "ic16x16.png" zum Piktogramm 1 hinzu.

Navigation zeigen