Funktionsreferenz

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.
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: Gibt 1 zurück.
Fehler: Gibt 0 zurück.

 

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

GUICtrlCreatePic, GUICtrlCreateIcon, GUICtrlCreateButton, GUICtrlCreateCheckbox

 

Beispiel


#include <GUIConstantsEx.au3>
#include <ButtonConstants.au3>

Opt('MustDeclareVars', 1)

Example()

Func Example()
    Local $msg

    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()

    ; Die Schleife wiederholt sich, bis der Benutzer die Beenden-Aktion der GUI auslöst
    While 1
        $msg = GUIGetMsg()

        If $msg = $GUI_EVENT_CLOSE Then ExitLoop
    WEnd
EndFunc   ;==>Example