WONTOP( ) (Función)

  • Artículo

Determina si la ventana especificada o activa está o no delante de todas las demás ventanas.

WONTOP([WindowName])

Valores devueltos

Character o Logical

Parámetros

  • WindowName
    Especifica el nombre de la ventana evaluada por WONTOP( ). Puede especificar el nombre de una ventana definida por el usuario creada con DEFINE WINDOW o de una ventana del sistema (Comandos, Sesión de datos, Examinar, etc.). Si omite WindowName, WONTOP( ) devuelve el nombre de la ventana en primer plano o activa. También puede incluir la cadena vacía en WindowName para especificar la ventana principal de Visual FoxPro.

    Si la ventana Depuración, Seguimiento o Comandos está activa y no especifica un nombre de ventana, WONTOP( ) devolverá el nombre de la última ventana que ha estado en primer plano. Si está depurando un programa que utiliza WONTOP( ), la ejecución del programa no se verá afectada al poner delante estas ventanas.

Observaciones

WONTOP( ) devuelve verdadero (.T.) si la ventana especificada está en primer plano. Si la ventana no está en primer plano o no existe, devuelve falso (.F.).

Ejemplo

En el siguiente ejemplo se utiliza WONTOP( ) para mostrar el nombre de la ventana activa. Antes de ejecutar este programa, abra algunas ventanas (Examinar, Sesión de datos, etc.) y después, ejecute el ejemplo.

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

Vea también

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