AutoIt.@ - Hilfe

Zu der Funktionsliste

GUICtrlCreateButton

Erstellt ein Button-Control für eine GUI

GUICtrlCreateButton ( <str> $Text , <int> $Links , <int> $Oberseite [ , <int> $Breite = -1 [ , <int> $Hoehe = -1 [ , <hex> $Stil = 0x100 [ , <hex> $erwStil = -1 ] ] ] ] )

Parameter

ParameterTypStandardwertBeschreibung
$Textstring (Zeichenkette) Der Text des Button-Controls
$Linksinteger (Ganzzahl) Der linke Rand des Elements. Bei -1 wird die Position angelehnt an GUICoordMode berechnet.
$Oberseiteinteger (Ganzzahl) Der obere Rand des Elements. Bei -1 wird die Position angelehnt an GUICoordMode berechnet.
$Breiteinteger (Ganzzahl)Breite von $Text[optional] Die Breite des Controls (Wenn nichts angegeben wurde, dann passt sich die Breite an $Text an).
$Hoeheinteger (Ganzzahl)Höhe von $Text[optional] Die Höhe des Controls (Wenn nichts angegeben wurde, dann passt sich die Höhe an $Text an).
$Stilhexadezimal$WS_TABSTOP[optional] Bearbeitet den Stil des Elements. Siehe unter GUI-Stil Anhang Standard (-1): kein Stil Erzwungener Stil: $WS_TABSTOP
$erwStilhexadezimal-1[optional] Bearbeitet den erweiterten Stil des Elements. Siehe unter GUI-Stil Anhang

Rückgabewert

Bei Erfolg: Gibt die Elementenkennung (ControlID) von dem neuen Element zurück.
Bei Fehler: Gibt 0 zurück.

Bemerkung

Um Information im Control zu bestimmen oder zu ändern, siehe GUICtrlUpdate.... Ein Schaltflächenelement kann ein Symbol (Icon) oder ein Bild anzeigen, indem man den $BS_ICON- bzw. den $BS_BITMAP-Stil verwendet. Durch die Verwendung vom GUICtrlSetImage()-Befehl kann man das Bild angeben. Um Stile mit den Standardstilen zu kombinieren, kann man BitOr($GUI_SS_DEFAULT_BUTTON, neuerStil, ...) verwenden. Um die oben genannten Werte verwenden zu können, muss man #include <ButtonConstants.au3> im Skript stehen haben. Standardgrößenänderung ist $GUI_DOCKSIZE (siehe GUICtrlSetResizing()).

In Verbindung stehende Befehle

AutoItSetOption
("GUICoordMode")
GUICtrlUpdate...
GUIGetMsg

Beispiel    

#include <GUIConstantsEx.au3>
 
Opt('MustDeclareVars', 1)
 
Beispiel()
 
Func Beispiel()
Local $Schaltflaeche1, $Schaltflaeche2, $Message
GUICreate("Meine GUI-Schaltfläche")
 
Opt("GUICoordMode", 2)
$Schaltflaeche1 = GUICtrlCreateButton("Editor starten", 10, 30, 100)
$Schaltflaeche2 = GUICtrlCreateButton("Testschaltfläche", 0, -1)
 
GUISetState()
 
; Führt das Skript solange aus, bis das GUI-Fenster geschlossen wurde
While 1
$Message = GUIGetMsg()
Select
Case $Message = $GUI_EVENT_CLOSE
ExitLoop
Case $Message = $Schaltflaeche1
Run('Notepad.exe') ; Startet den Editor
Case $Message = $Schaltflaeche2
MsgBox(0, "AutoIt.@", "Test: Die 2. Schaltfläche wurde angeklickt.")
EndSelect
WEnd
EndFunc ;==>Beispiel