Funktionsreferenz

GUICtrlGetState

Liefert den aktuellen Status eines Controls.

GUICtrlGetState ( [controlID] )

Parameter

ControlID

[optional] Die Identifikationsnummer des Controls (Control-ID), wie von einer GUICtrlCreate... Funktion zurückgegeben.

Rückgabewert

Erfolg:	Gibt den Status zurück. Die Werte findet man unter GUICtrlSetState
Fehler:	Gibt -1 zurück, 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>

Opt('MustDeclareVars', 1)

Example()

Func Example()
Local $n, $msg

GUICreate("Meine GUI (GetControlState)")
$n = GUICtrlCreateCheckbox("Checkbox", 10, 10)
GUICtrlSetState(-1, 1) ; Checkbox markieren

GUISetState() ; Zeigt das leere GUI-Fenster

; 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

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