Funktionreferenz


WinClose

Beschreibung anzeigen in

Schließt ein Fenster.

WinClose ( "title" [, "text"] )

Parameter

title Der Titel, das Handle oder die Klasse des zu schließenden Fensters. Siehe Erweiterte Fenstertiteldefinition.
text [optional] Der Text des zu schließenden Fensters. Standardwert ist ein Leerstring. Siehe Erweiterte Fenstertextdefinition.

Rückgabewert

Erfolg: 1.
Fehler: 0, wenn das Fenster nicht geschlossen werden konnte.

Bemerkungen

Diese Funktion sendet einen Schließen/Beenden-Befehl an das angegebene Fenster. Das Ergebnis ist abhängig vom Status des Programms. Sind z.B. noch geänderte Dokumente offen, so wird es nachfragen, ob die Daten gesichert werden sollen. Um das Schließen eines Fensters zu erzwingen ist die WinKill() Funktion zu verwenden. Falls mehrere Fenster das Kriterium erfüllen, wird das zuletzt aktive Fenster geschlossen.

Verwandte Funktionen

ProcessClose, WinActivate, WinExists, WinKill, WinMove, WinSetState, WinTitleMatchMode (Option)

Beispiel

#include <MsgBoxConstants.au3>

Example()

Func Example()
    ; Startet den Editor
    Run("notepad.exe")

    ; Wartet 2 Sekunden bis das Editorfenster dargestellt wird.
    Sleep(2000)

    ; Schließt das Editorfenster durch die Verwendung des Klassennamens (classname) vom Editor.
    If WinClose("[CLASS:Notepad]", "") Then
        MsgBox($MB_SYSTEMMODAL, "", "Fenster geschlossen")
    Else
        MsgBox($MB_SYSTEMMODAL + $MB_ICONERROR, "Fehler", "Fenster nicht gefunden")
    EndIf
EndFunc   ;==>Example