GUICtrlSetImage
Bestimmt das Bitmap- oder Iconbild, das für ein Control verwendet wird.
GUICtrlSetImage ( controlID, filename [, iconname [, icontype]] )
Parameter
| ControlID | Die Identifikationsnummer des Controls (Control-ID), wie von einer GUICtrlCreate... Funktion zurückgegeben, oder -1 für das zuletzt erzeugte Control. |
| filename | Der Dateiname des Bildes, das auf dem Control angezeigt werden soll. |
| iconname | [optional] Der Icon Name, falls die Datei mehrere Icons enthält. Dies kann eine Ordinalzahl sein, falls es eine negative Zahl aufweist. Sonst -1. |
| icontype | [optional] Um eine bestimmte Icongröße auszuwählen: 0 = klein, 1 = normal (Standard). für TreeViewItem bedeutet die Icongröße : 2 = ausgewählt/markiert, 4 nicht markierter Eintrag. |
Rückgabewert
| Erfolg: | 1. |
| Fehler: | 0. |
Bemerkungen
Um den Wert des gültigen Iconnamens in einer Datei zu erhalten ist ein "resource hacker" zu verwenden.
Wenn die Funktion auf einen Button angewendet wird, wird das Bild auf dem Button angezeigt. Bilder können auch für Checkbox-Items verwendet werden, wenn der $BS_PUSHLIKE Stil benutzt wird. In beiden Fällen muss der $BS_ICON- oder $BS_BITMAP-Stil angegeben werden, um den Typ des verwendeten Bildes festzulegen. Die erste Auflösung des Icons wird verwendet, falls es sich um ein Icon mit mehreren Auflösungen handelt.
Falls zum Beispiel das Control 64x64 groß ist und das Icon 128x128, wird das Bild abgeschnitten.
!!! Falls dieser Befehl auf einem TreeViewItem das erste Mal verwendet wird, dann werden alle anderen Einträge dieses Icon bzw. Bild automatisch als Standard verwenden !!!
Falls GUICtrlSetImage() auf einem TreeView oder ListView verwendet wird, dann werden alle Einträge auf dieses Icon bzw. Bild geändert.
Die Angabe einer positiven Zahl bezieht sich auf den "string-equivalenten" Icon-Namen.
Die Angabe einer negativen Zahl führt zu zahlenbasiertem "Index"-Verhalten. Einige DLLs können Icons nur mit negativen Zahlen entpacken.
- - - - - - - - Erklärung der Controls - - - - - - - -
Verwandte Funktionen
GUICtrlCreateButton, GUICtrlCreateCheckbox, GUICtrlCreateIcon, GUICtrlCreatePic
Beispiel
#include <ButtonConstants.au3>
#include <GUIConstantsEx.au3>
Example()
Func Example()
GUICreate("Meine GUI") ; Erstellt ein GUI-Fenster welches mittig ausgerichtet wird
GUICtrlCreateButton("Mein Bild-Button", 10, 20, 40, 40, $BS_ICON)
GUICtrlSetImage(-1, "shell32.dll", 22)
GUISetState(@SW_SHOW)
; Die Schleife wiederholt sich, bis der Benutzer die Beenden-Aktion der GUI auslöst.
While 1
Switch GUIGetMsg()
Case $GUI_EVENT_CLOSE
ExitLoop
EndSwitch
WEnd
EndFunc ;==>Example