_DebugSetup

Beschreibung anzeigen in

Startet eine Debug-Sitzung durch Verwendung einer festgelegten Reportart

#include <Debug.au3>
_DebugSetup ( [$sTitle = Default [, $bBugReportInfos = False [, $vReportType = 1 [, $vLogFile = "" [, $bTimeStamp = False]]]]] )

Parameter

$sTitle	[optional] Titel, der dem Berichts-Fenster zugewiesen wird. Der Standardwert lautet "AutoIt Debug Report".
$bBugReportInfos	[optional] Zeigt BugReport Infos. Standard ist False.
$vReportType	[optional] 1 - Report-Logfenster (Standard). 2 - ConsoleWrite. 3 - MsgBox. 4 - FileWrite (in $vLogFile wird der Dateiname definiert). 5 - Report-Notepadfenster (siehe Bemerkungen für Windows 11) 6 - Protokollfenster mit Zeitüberschreitung (see remark for Windows 11). string - Name der zu verwendenden Reportfunktion.
$vLogFile	[optional] Name der Datei falls $vReportType = 4 Timeout in Sekunden, falls $vReportType = 6 (Standard = 10)
$bTimeStamp	[optional] True wenn die Nachricht mit einem Zeitstempel vorangestellt wird "YYYY/MM/DD HH:MM:SS"

Rückgabewert

Erfolg:	Reporttyp.
Fehler:	Setzt das @error Flag auf ungleich 0
@error:	1 falls bereits aufgerufen. 2 ungültiger Reporttyp. 3 ungültige CallBack-Funktion

Bemerkungen

Falls eine festgelegte Reportfunktion registriert ist, dann wird diese beim Beenden von AutoIt ohne Parameter aufgerufen.

Man kann jeweils nur eine Debug-Sitzung im laufenden Skript geöffnet haben.
Man kann mehrere Skripte in der selben Debug-Sitzung verwenden, man muss dann nur denselben $sTitle verwenden, wenn _DebugSetup() aufgerufen wird. Alle Ausgaben von _DebugOut() erfolgen dann in dieselbe Debug-Sitzung.

Wenn der Aufruf zu _DebugSetup() auskommentiert wird, werden die Aufrufe der Funktion _Debug...() ignoriert. Es wird aber empfohlen, im endgültigen Skript alle Aufrufe von _Debug-Funktionen zu entfernen.

Wenn der "Report Log Window" Typ verwendet wird, dann wird das erst Script beim Schließen des Berichtsfensters beendet.

Wenn der Typ „Report Notepad Window” verwendet wird, kann das Notepad-Fenster unter Windows 11 nicht geschlossen werden, ohne dass eine Registrierung angefordert wird.
Daher wird der Inhalt des Fensters in die Zwischenablage kopiert und vor dem Schließen des Skripts in einem MsgBox-Fenster angezeigt.
Wenn das Skript im Admin-Modus ausgeführt wird, wird wie unter Windows 10 das alte Notepad verwendet (siehe Beispiel 2).

Beispiel

Beispiel 1

#cs ----------------------------------------------------------------------------
    
    AutoIt Version:     3.2.8.1
    Autor:              David Nuttall
    
    Skriptfunktion:     Dieses Grundlagenskript zeigt die Funktionalität der Debug-Funktionen
    
#ce ----------------------------------------------------------------------------

#include <Debug.au3>

_DebugSetup("Teste Excel") ; Beginnt mit dme anzeigen der Debug-Umgebung
For $i = 1 To 4
    WinActivate("Microsoft Excel")
    ; Mit Excel arbeiten
    Send("{Down}")
    _DebugOut("Maus wurde nach unten bewegt.") ; Schreibt die Ausgabe in ein Editor-Fenster
Next

Beispiel 2 Skript unter Verwendung des Report Notepad-Fensters (5)

; ermöglicht die Ausführung mit dem alten Notepad-Verhalten in Windows 11
#RequireAdmin

#include <Debug.au3>

_DebugSetup("Check Excel", True, 5) ; Bericht Notepad-Fenster
For $i = 1 To 4
    WinActivate("Microsoft Excel")
    ; ; mit Excel interagieren
    Send("{Down}")
    _DebugOut("Moved Mouse Down") ; zwingt das Debug-Notepadfenster, die Kontrolle zu übernehmen
Next

Funktionreferenz