AutoIt.@ - Hilfe
GUICreate
Erstellt ein GUI Fenster (Graphical User Interface -> Grafische Benutzeroberfläche)
GUICreate ( <str> $Titel [ , <int> $Breite = 400 [ , <int> $Hoehe = 400 [ , <int> $Links = -1 [ , <int> $Oberseite = -1 [ , <hex> $Stil = 0xCA80 [ , <hex> $erwStil = -1 [ , <handle> $Elter = 0 ] ] ] ] ] ] ] ) Parameter
| Parameter | Typ | Standardwert | Beschreibung |
| $Titel | string (Zeichenkette) | | Der Titel des GUI-Fensters. |
| $Breite | integer (Ganzzahl) | 400 | [optional] Die Breite des GUI-Fensters. |
| $Hoehe | integer (Ganzzahl) | 400 | [optional] Die Höhe des GUI-Fensters. |
| $Links | integer (Ganzzahl) | Mitte des Fensters | [optional] Die linke Position des GUI-Fensters (Standard: -1, Mitte des Fensters). Falls dieser Wert definiert wurde, muss auch die Oberseite definiert werden. |
| $Oberseite | integer (Ganzzahl) | Mitte des Fensters | [optional] Die obere Position des GUI-Fensters (Standard: -1, Mitte des Fensters). |
| $Stil | hexadezimal | 0xCA80 | [optional] Bearbeitet den Stil des GUI-Fensters. Siehe unter: GUI-Stil Anhang. (Standard: -1, beinhaltet: $WS_MINIMIZEBOX, $WS_CAPTION, $WS_POPUP, $WS_SYSMENU Stile.
Einige Stile sind immer eingebunden: $WS_CLIPSIBLINGS, und $WS_SYSMENU, falls $WS_MAXIMIZEBOX oder $WS_SIZEBOX) |
| $erwStil | hexadezimal | -1 | [optional] Bearbeitet den erweiterten Stil (extended style) des GUI-Fensters. Siehe unter: GUI-erweiterte Darstellung Anhang. |
| $Elter | handle (Kennung) | 0 | [optional] Der Elter (parent) von einem zuvor erstellten Fenster. Dieses Fenster wird dann zum Kind des Elters. |
Rückgabewert
| Bei Erfolg: | Gibt den Handle des GUI-Fensters zurück. |
| Bei Fehler: | Gibt 0 zurück (falls das GUI-Fenster nicht erstellt werden konnte und setzt @error zu 1) |
Bemerkung
Standardmäßig ist das GUI-Fenster nicht maximierbar und die größe nicht veränderbar. Als Style kann
$WS_MAXIMIZEBOX und
$WS_SIZEBOX benutzen, um das GUI-Fenster skalierbar und maximierbar zu machen.
| Erweitertes Style | Wert | Ergebnis |
| $WS_EX_ACCEPTFILES | 0x10 / 16 | Erlaubt einem Edit- oder Inputfeld innerhalb des GUI's Dateipfäde per Drag'n'Drop Das Textefeld muss zusätzlich den $GUI_DROPACCEPTED-Status mit dem Befehl GUICtrlSetState() erhalten. Andere Elemente können die Drag'n'Drop-Information über @GUI_DRAGID, @GUI_DRAGFILE und @GUI_DROPID auslesen. |
In Verbindung stehende Befehle
Beispiel 1
#include
#include
Opt('MustDeclareVars', 1)
Beispiel()
Func Beispiel()
Local $msg
GUICreate("Mein GUI")
GUISetState(@SW_SHOW) ; Zeigt das GUI-Fenster an
; Läuft, solange das GUI offen ist
While 1
$msg = GUIGetMsg()
If $msg = $GUI_EVENT_CLOSE Then ExitLoop
WEnd
GUIDelete() ; Löscht das GUI-Fenster
EndFunc ;==>Beispiel
Beispiel 2
#include
#include
Opt('MustDeclareVars', 1)
Func Beispiel()
Local $GUI, $Hintergrund, $Bild, $Logo, $msg
; Die Bilder befinden sich im AutoIt-Verzeichnis:
; C:\Program Files\AutoIt3\Examples\GUI
Local $sDatei = "..\GUI\logo4.gif"
$GUI = GUICreate("Hintergrund", 400, 100)
; Hintergrundbild
$Hintergrund = GUICtrlCreatePic("..\GUI\msoobe.jpg", 0, 0, 400, 100)
GUISetState(@SW_SHOW)
; Transparentes MDI-Kind-GUI
$pic = GUICreate("", 169, 68, 20, 20, $WS_POPUP, BitOR($WS_EX_LAYERED, $WS_EX_MDICHILD), $GUI)
; Transparentes Bild
$Logo = GUICtrlCreatePic($sDatei, 0, 0, 169, 68)
GUISetState(@SW_SHOW)
Do
$msg = GUIGetMsg()
Until $msg = $GUI_EVENT_CLOSE
EndFunc ;==>Beispiel
#include <GUIConstantsEx.au3>
#include <WindowsConstants.au3>
Opt('MustDeclareVars', 1)
Func Beispiel()
Local $GUI, $Hintergrund, $Bild, $Logo, $msg
; Die Bilder befinden sich im AutoIt-Verzeichnis:
; C:Program FilesAutoIt3ExamplesGUI
Local $sDatei = "..GUIlogo4.gif"
$GUI = GUICreate("Hintergrund", 400, 100)
; Hintergrundbild
$Hintergrund = GUICtrlCreatePic("..GUImsoobe.jpg", 0, 0, 400, 100)
GUISetState(@SW_SHOW)
; Transparentes MDI-Kind-GUI
$pic = GUICreate("", 169, 68, 20, 20, $WS_POPUP, BitOR($WS_EX_LAYERED, $WS_EX_MDICHILD), $GUI)
; Transparentes Bild
$Logo = GUICtrlCreatePic($sDatei, 0, 0, 169, 68)
GUISetState(@SW_SHOW)
Do
$msg = GUIGetMsg()
Until $msg = $GUI_EVENT_CLOSE
EndFunc ;==>Beispiel