AutoIt.@ - Tools und Hilfeforum

1) Ein GUI erstellen und anzeigen

Das erste Skript zeigt uns, wie man ein GUI erstellt, und anzeigt:



Erklärung:
Zuerst einmal das #include. Für Leute die nicht wissen, was includes sind, werden sie jetzt noch mal erklärt. Includes, sind schon vorhandene Skripte, in einem Include-Ordner (Normalerweise: C:\Program Files\AutoIt3\Include), die in dein Skript mit eingebunden sind. In diesen Skripten, sind Funktionen, oder Variablen, o.ä. die man in seinem eigenen Skript dann benutzen kann. In den GUIConstantsEx.au3 sind Variablen, mit denen man das GUI schließen kann. Mehr zu den Variablen später.
Includes werden so geschrieben:



Kommen wir zu GUICreate. Mit GUICreate kann man ein GUI erstellen. Der erste Parameter ist der Titel der GUI. Er wird in Anführungszeichen geschrieben. Danach kommt die Breite und als letztes die Höhe. Weitere Parameter sind Positionen, Styles (s.Hilfe)!!
In diesem Skript wird die GUI als Variable $hGUI definiert. Das ist in diesem Skript nicht wirklich notwendig, aber später wird das definieren wichtig sein.
Als letztes wird die GUI angezeigt. Das geht mit der Funktion GUISetState. Wie man aus dem Namen lesen kann, wird der Zustand der GUI gesetzt. Das Makro @SW_SHOW bedeutet zeigen. Mehr zu den Makros in der Hilfe.
Wenn Sie vielleicht mal das Skript geöffnet haben, werden Sie feststellen, dass die GUI sich öffnet, aber sofort wieder schließt. Das liegt daran, dass das Skript die GUI erstellt, anzeigt, und dann beendet. Vielleicht kommt in ihrem Hinterkopf schon der Gedanke „ein Schleife“ auf. Wenn nicht, ist auch nicht so schlimm!

2) Ein GUI schließen

Um mit einem GUI Aktionen (z.B Beenden; angeklickte Buttons) zu registrieren gibt es zwei Möglichkeiten dies zu tun. Die eine Möglichkeit ist der OnEvent Modus, der andere der Message-Loop Modus.

2.1) Message-Loop Modus

Der Message-Loop Modus wird in einer Schleife verwendet. Die Schleife fragt die GUI permanent nach einem Ereignis mit der GUIGetMsg-Funktion.
Der Message-Loop Modus ist der Standart-Modus für AutoIt-GUIs. Es gibt zwei grundlegende Möglichkeiten den Message-Loop Modus in einer Schleife zu verwenden. Man könnte dazu eine Do-Until Schleife oder eine While Schleife benutzen. Gehen wir gleich zum Schließen der GUI. Das Schließen der GUI ist ein System-Ereignis, und System-Ereignisse sind negative Zahlen. Diese Zahlen sind in der au3-Datei GUIConstantsEx.au3 als Variablen definiert. Man könnte sie auch selber hinschreiben, aber sie sind so schwerer zu merken. Die Variable für Schließen ist $GUI_EVENT_CLOSE. Damit auch was passiert, wenn das GUI geschlossen werden soll, braucht man noch If, Switch oder Select. Hier wird If benutzt. Die Funktion GUIGetMsg stellt ja nichts an, sondern registriert nur den Befehl. Eine normale Message-Loop Schleife mit While sieht so aus:



Mit Do-Until sieht es folgendermaßen aus:



Wir werden die Do-Until Version nicht mehr benutzen, da das GUI so nur geschlossen werden kann. Man könnte keine anderen Ereignisse für den Message-Loop Modus einbauen.
Wenn wir die While Version in unser altes GUI-Script einbauen sieht es folgendermaßen aus:



Noch mal eine Erklärung. While 1 wird ständig wiederholt. Das heißt GUIGetMsg (Fragen nach Ereignissen) wird ständig wiederholt. Das Switch bedeutet: Falls das Ereignis $GUI_EVENT_CLOSE ist, also der Schließen-Button, dann soll das Script beendet werden (Exit).

2.2) OnEventMode

Der OnEventMode ist anders als der Message-Loop Modus. Er hat sehr viel mit Funcs zutun.
Falls Sie jetzt nicht wissen, was eine Func ist, dann brauchen sie nicht weiterzulesen. Der Message-Loop Modus reicht für den Anfang. Lesen Sie lieber bei den Controls weiter. Ich setzte beim OnEventMode voraus, das Sie vorher Message-Loop Modus gelesen haben!

Der OnEventMode lässt eine Funktion bei einem Ereignis starten. Ein Ereignis erstellen, geht mit GUISetOnEvent. Dort gibt man an, was für ein Event das ist, und welche Func aufgerufen werden soll. Das heißt, sie schreiben z.B eine Func mit den Namen Exit, in der ein Script beendet wird. Wenn man auf den Schließen-Button klickt, dann unterbricht OnEvent alles, was gerade im Skript läuft, und ruft diese Funktion auf. OnEvent ist nicht der Standart Modus, deshalb muss er am Anfang des Scriptes mit Opt(’GUIOnEventMode’, 1) angeschaltet werden. Im nächsten Script ist der OnEventMode gleich mit dem alten GUI-Skript verbunden.

3) Controls

In diesem Tutorial werden nur 2 von vielen Controls verwendet. Da jedoch die Control-Erstellung in vielen Fällen ähnlich bis gleich ist, werden wir nur 2 Controls behandeln. Den Button-Control und den Input-Control.

3.1) Controls im Message-Loop Modus

Fangen wir erst einmal an Controls zu erstellen. Controls sollten immer vor GUISetState(@SW_SHOW) erstellt werden. Eine Control-Erstellung geht mit GUICtrlCreate…. Nehmen wir uns erstmal die Control-Erstellung vor. Unser altes GUIScript sieht mit Controls folgendermaßen aus:



GUICtrlCreateInput erstellt einen Input-Control. Der Rückgabewert ist die Control-ID des Inputs, die als $hInput definiert wird. Man muss eine Control-ID nicht definieren, aber wenn man später eine Aktion mit dem Control machen will, dann braucht man die ID. Werden Sie später sehen!! Als erster Parameter sind zwei Anführungszeichen angegeben. Wieso?? Der erste Parameter ist das, was schon im Input drinnen steht, beim öffnen der GUI. Bei 2 Anführungszeichen steht nichts in der GUI. Die nächsten 2 Parameter sind Left-, und Toppositionen in der GUI. Und die letzten sind die Breite und Höhe.

Das Selbe ist beim Button-Control. Das erste ist die Beschriftung, danach wieder Left-, Toppositionen, Breite und Höhe. Das ist bei fast jedem Control so. Aber nun wollen wir die Controls mit Funktionen versehen. Das geht folgendermaßen:



Dafür braucht man die Control-ID eines Controls. GUICtrlRead ist eine sehr wichtige Funktion. Sie kann Controls auslesen. Das auslesen ist bei den Controls verschieden. Bei einer Input-Box liest GUICtrlRead die Buchstaben heraus. Diese werden dann als Variable $read definiert und mit einer MsgBox ausgegeben.

3.2) Controls im OnEventMode

Dieses Kapitel schließt voraus, dass das Kapitel 3.1) gelesen wurde!!

Beim OnEventMode, wird wieder ein Event für den Control erstellt. GUIEvents erstellt man mit GUISetOnEvent. Control-Events werden aber mit GUICtrlSetOnEvent erstellt!!! Beim OnEventMode sieht das ganze folgendermaßen aus:

4) Mehrere GUIs in einem Script

Dieses Kapitel ist schon etwas komplexer. Wenn sie grade ein Anfänger sind, dann hören sie auf, und spielen ein wenig mit Controls herum. Wenn sie jedoch schon etwas Erfahrung in GUIs haben, oder wenigstens in AutoIt, dann können sie getrost weiterlesen.

Es gibt mehrere Möglichkeiten um mehrere GUIs in einem Script zu haben. Dieses Kapitel zeigt zwei von ihnen.

4.1) Func erstellt neues GUI

Zuerst zeigen wir mal das Skript:



Jetzt kommt die Erklärung: Beim eigentlichen Schließen der GUI wird jetzt nicht Exit ausgeführt, sondern eine Func. Diese Func löscht die vorherige GUI, also sie zerstört es. (GUIDelete). Und erstellt eine neue GUI. Wenn man jetzt noch mal auf schließen drückt, dann beendet sich das Script wirklich.

4.2) Neues GUI wird nach beenden erstellt

Zuerst wieder das Skript:



Der wesentliche Unterschied hier, ist, dass beim Schließen nicht Exit, sonder ExitLoop angewendet wird, dass heißt, die Schleife wird beendet. Da das Skript dort aber nicht zu Ende ist, beendet das Skript sich auch nicht. GUIDelete löscht das GUI wieder. Danach wird ein neues GUI erstellt und angezeigt. Beim Schließen wird dieses mal Exit benutzt.

Das war schon alles vom Tutorial. Vielleicht haben Sie jetzt einen kleinen Überblick, was man alles mit GUIs anfangen kann. Und man kann damit viel anfangen. Ich hoffe es hat Ihnen gefallen. Tutorial geschrieben von Bakku.