Funktionreferenz


WinSetOnTop

Beschreibung anzeigen in

Verändert das "Always On Top"-Attribut ("immer im Vordergrund"-Attribut) eines Fensters.

WinSetOnTop ( "title", "text", flag )

Parameter

title Der Titel/Fenster-Handle(hWnd)/Klassenname(class) des Fensters, das verändert werden soll. Siehe Erweiterte Fenstertiteldefinition.
text Der Text des Fensters, das verändert werden soll. Siehe Erweiterte Fenstertextdefinition.
flag Legt fest, ob das "TOPMOST" Flag für das Fenster gesetzt werden soll.
    $WINDOWS_NOONTOP (0) = Topmost-Flag wird gelöscht
    $WINDOWS_ONTOP (1) = setzt das Topmost-Flag

Die Konstanten sind in "AutoItConstants.au3" definiert.

Rückgabewert

Erfolg: 1.
Fehler: 0 wenn das Fenster nicht gefunden wurde.

Bemerkungen

Bei Programmen von anderen Anbietern, die ein "Always On Top" im Kontextmenü haben, wird die Anzeige evtl. nicht aktualisiert, wenn dieses Flag durch AutoIT geändert wird.

Verwandte Funktionen

WinSetState

Beispiel

#include <AutoItConstants.au3>

Example()

Func Example()
    ; Ermittelt das Handle des aktiven Fensters
    Local $hWnd = WinGetHandle("[ACTIVE]")

    ; Setzt das aktive Fenster durch die Verwendung des von WinGetHandle zurückgegebenen Handles in den Vordergrund.
    WinSetOnTop($hWnd, "", $WINDOWS_ONTOP)

    ; Wartet 2 Sekunden um die Änderung darzustellen
    Sleep(2000)

    ; Enfernt den "topmost" Status von dem aktiven Fenster wieder.
    WinSetOnTop($hWnd, "", $WINDOWS_NOONTOP)
EndFunc   ;==>Example