Schlüsselwortreferenz

#include

Bindet eine Datei in das aktuelle Skript ein.

#include "[path\]filename"
#include <filename>

 

Parameter

filename Der Dateiname des Skriptes, das eingebunden werden soll. Der Pfad ist optional. Er muss einen String sein - er darf keine Variable sein.
Wenn "..." verwendet wird, wird der Dateiname als relativ zum aktuellen Skript aufgefasst.
Wenn <...> verwendet wird, wird der Dateiname als relativ zum Include-Verzeichnis aufgefasst (normalerweise C:\Programme\AutoIt3\Include). Das Include-Verzeichnis beinhaltet bereits viele vor-produzierte Funktionen, die eingebunden und dann verwendet werden können.

 

Bemerkungen

In einem AutoIt-Skript können andere Skripte mittels des #include-Kommandos eingebunden werden.

Wenn man eine Datei mehrfach einbindet und damit eine Funktion mehrfach existieren würde, wird man folgenden Fehler erhalten: "Duplicate function". Wenn man eine Include-Datei schreibt, die das verursachen könnte, muss man sicherstellen, dass die erste Zeile #include-once beinhaltet, sodass die Datei nicht mehrfach eingebunden werden kann.

Es gibt einen besonderen Registrywert, namens "Include" welche in "HKEY_CURRENT_USER\Software\AutoIt v3\AutoIt" erstellt wurde. Es sollte ein REG_SZ (String) Wert sein. Die Inhalte dieses Wertes sind durch ein Semikolon getrennte Verzeichnisse, welche zusätzlich zu den Standardordnern durchsucht werden sollten, wenn #include's im Skript angegeben wird.

Der von AutoIt verwendete Suchordner ist unterschiedlich, je nachdem welche Form von #include verwendet wird. Die untenstehenden Tabellen zeigen welche Ordner bei den beiden Formen durchsucht werden.

Using #include <>
Standard library Der Pfad des aktuell laufenden Interpreter mit dem Anhang "\Include" wird durchsucht.
User-defined libraries Der oben erwähnte Registrywert wird gelesen und jedes Verzeichnis wird in der Reihenfolge durchsucht in der sie erscheinen.
Script directory Das Verzeichnis des momentan ausgeführten Skripts.

Using #include "" (Dies ist die Umkehrung von #include <>).
Script directory Das Verzeichnis des momentan ausgeführten Skripts.
User-defined libraries Der oben erwähnte Registrywert wird gelesen und jedes Verzeichnis wird in der Reihenfolge durchsucht in der sie erscheinen.
Standard Library Der Pfad des aktuell laufenden Interpreter mit dem Anhang "\Include" wird durchsucht.

Folgendes ist bei der Verwendung der /AutoIt3ExecuteScript Option zu beachten. Seit die Standard-Library im aktuellen Interpreter's Verzeichnis durchsucht wird, wird die Standard-Library-Funktion nicht mehr gefunden; Diese Library wird nur noch gefunden, wenn AutoIt3.exe durchlaufen wird. Es ist empfehlenswert, ein Skript in das .a3x Format zu kompilieren, bevor man versucht es mit /AutoIt3ExecuteScript laufen zu lassen.

Aut2Exe verwendet den selben Algorithmus wie AutoIt3.exe, mit dem einzigen Unterschied, dass es nach dem Sub-Include-Ordner auch in einem Schwesternordner zu sich selbst schaut (..\Include).

Falls Opt("TrayIconDebug",1) können nur 64 include Dateinamen im Tray-ToolTip dargestellt werden. Bei den anderen wird kein Dateiname angezeigt.

 

Verwandte Funktionen

#include-once

 

Beispiel


;;; TIME.AU3 ;;;
MsgBox(0,"", "Die Zeit ist " & @HOUR & ":" & @MIN & ":" & @SEC)

;;; SCRIPT.AU3 ;;;
#include "TIME.AU3"
MsgBox(0,"", "Beispiel")
#include "TIME.AU3"
Exit

; Das Ausführen von script.au3 zeigt 3 Dialogboxen an
; Eine mit der Zeit, eine mit 'Beispiel' und eine weitere mit der Zeit.