Funktionsreferenz

WinActivate

Holt ein bestimmtes Fenster in den Vordergrund und setzt den Fokus auf dasselbe.

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

 

Parameter

title Der Titel des Fensters, welches in den Vordergrund gebracht werden soll. Hier: Erweiterte Fenstertiteldefinition.
text [optional] Der Text des Fensters, welches in den Vordergrund gebracht werden soll.

 

Rückgabewert

Erfolg: Gibt das Handle des Fensters zurück.
Fehler: Gibt 0 zurück, wenn das Fenster nicht gefunden wurde oder nicht aktiviert werden konnte.

 

Bemerkungen

Mit der "WinActive"-Funktion kann geprüft werden, ob "WinActivate" erfolgreich war. Falls mehrere Fenster die Kriterien erfüllen, wird das zuletzt aktive Fenster aktiviert. "WinActivate" funktioniert auch mit minimierten Fenstern. Trotzdem kann ein Fenster, welches den Status "immer im Vordergrund" hat, das aktivierte Fenster überlappen bzw. überdecken.

@extended enthält zusätzliche Infos, wie der Aktivierungsprozess erledigt wurde.

 

Verwandte Funktionen

WinClose, WinSetState, WinTitleMatchMode (Option), WinKill, WinMove

 

Beispiel


WinActivate("[CLASS:Notepad]", "")