Funktionreferenz


GUICtrlGetState

Beschreibung anzeigen in

Liefert den aktuellen Status eines Controls.

GUICtrlGetState ( controlID )

Parameter

ControlID Die Identifikationsnummer des Controls (Control-ID), wie von einer GUICtrlCreate... Funktion zurückgegeben, oder -1 für das zuletzt erzeugte Control.

Rückgabewert

Erfolg: Den Status. Die Werte findet man unter GUICtrlSetState()
Fehler: -1 wenn das Control nicht definiert ist.

Bemerkungen

Im Gegensatz zu GUICtrlRead() liefert diese Funktion nur den Status eines Controls (aktiviert, deaktiviert, versteckt, sichtbar, drag and drop erlaubt)

Ausnahme:
Auf ListView-Controls (Listen mit mehreren Spalten) angewendet wird die Nummer der angeklickten Spalte zurückgegeben.

- - - - - - - - Erklärung der Controls - - - - - - - -

Verwandte Funktionen

GUICtrlRead, GUICtrlSetState

Beispiel

#include <GUIConstantsEx.au3>
#include <MsgBoxConstants.au3>

Example()

Func Example()
    GUICreate("Meine GUI (GetControlState)")
    Local $idCheckbox = GUICtrlCreateCheckbox("Checkbox", 10, 10)
    GUICtrlSetState(-1, 1) ; Checkbox markieren

    GUISetState(@SW_SHOW) ; Macht die GUI sichtbar

    ; 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

    MsgBox($MB_SYSTEMMODAL, "Status", StringFormat("GUICtrlRead=%d\nGUICtrlGetState=%d", GUICtrlRead($idCheckbox), GUICtrlGetState($idCheckbox)))
EndFunc   ;==>Example