WONTOP( )-Funktion

Stellt fest, ob das aktive oder angegebene Fenster sich vor allen anderen Fenstern befindet.

WONTOP([WindowName])

Rückgabewerte

Zeichen oder logisch

Parameter

• WindowName
  Gibt den Namen des Fensters an, das WONTOP( ) auswertet. Sie können den Namen eines benutzerdefinierten Fensters angeben, das mit DEFINE WINDOW erstellt wurde, oder ein Systemfenster (Befehl, Datensitzung, Datenblattfenster usw.). Wenn Sie WindowName nicht angeben, gibt WONTOP( ) den Namen des obersten oder aktiven Fensters zurück. Sie können für WindowName auch eine leere Zeichenfolge angeben, um sich auf das Visual FoxPro-Hauptfenster zu beziehen.

  Wenn eines der Fenster Debug, Überwachung oder Befehl aktiv ist und Sie keinen Fensternamen angeben, gibt WONTOP( ) den Namen des Fensters zurück, das zuletzt im Vordergrund stand. Wenn Sie ein Programm debuggen, das WONTOP( ) verwendet, wird die Programmausführung nicht dadurch beeinflusst, dass diese Fenster in den Vordergrund gestellt werden.

Hinweise

WONTOP( ) gibt Wahr (.T.) zurück, wenn das angegebene Fenster aktiv ist. WONTOP( ) gibt Falsch (.F.) zurück, wenn das Fenster nicht aktiv oder nicht vorhanden ist.

Beispiel

Im folgenden Beispiel wird mit Hilfe von WONTOP( ) der Name des aktiven Fensters angezeigt. Öffnen Sie einige Fenster, bevor Sie dieses Programm ausführen (Befehl, Datensitzung, Datenblattfenster usw.). Führen Sie anschließend das Beispiel aus.

IF NOT EMPTY(WONTOP( ))
   WAIT WINDOW 'Frontmost window: ' + WONTOP( )
ELSE
   WAIT WINDOW 'No windows are open'
ENDIF

Siehe auch

ACTIVATE WINDOW | DEFINE WINDOW | WEXIST( ) | WOUTPUT( ) | WVISIBLE( )