Compartir a través de

WTITLE( ) (Función)

  • Artículo

Devuelve el título asignado a la ventana activa o especificada.

WTITLE([WindowName])

Valores devueltos

Character

Parámetros

  • WindowName
    Especifica una ventana cuyo título devuelve WTITLE( ). Si incluye el nombre de una ventana definida por el usuario creada con DEFINE WINDOW, se devuelve el título asignado a la ventana con la cláusula TITLE.

    Al ejecutar BROWSE WINDOW para abrir una ventana Examinar en una ventana definida por el usuario, WTITLE( ) devuelve el título de la ventana definida por el usuario si la ventana Examinar no tiene título. WTITLE( ) devuelve el título de la ventana Examinar siempre que esta ventana tenga un título.

    También puede utilizar la cadena vacía de WindowName para especificar la ventana principal de Visual FoxPro.

Observaciones

WTITLE( ) puede utilizarse para devolver el título de una ventana, que aparece en el borde superior de la ventana. Si omite WindowName, se devolverá el título de la ventana activa. WTITLE( ) devolverá la cadena vacía si la ventana Depuración, Seguimiento o Comando están activas, o si el resultado se está dirigiendo a la ventana principal de Visual FoxPro.

Nombres y títulos de ventanas   Se asignan nombres a las ventanas definidas por el usuario, a las ventanas del sistema, a las barras de herramientas (en Visual FoxPro) y a las ventanas Examinar de la forma siguiente:

A las ventanas definidas por el usuario se les asignan nombres cuando se crean con DEFINE WINDOW. Hay una distinción entre los nombres y los títulos de las ventanas definidas por el usuario. De forma predeterminada, las ventanas definidas por el usuario no tienen títulos. Si se incluye la cláusula TITLE al crear la ventana, aparecerá el título especificado en el borde superior de la ventana, pero no será el nombre de la ventana.

De forma predeterminada, cada ventana del sistema, que es parte de la interfaz de Visual FoxPro, obtiene su nombre del título de la ventana. Ejemplos de ventanas del sistema son la ventana Comandos, la ventana Sesión de datos y la ventana Seguimiento. En Visual FoxPro, cada barra de herramientas recibe su nombre a partir del título de la barra de herramientas.

Las ventanas de programa y edición, así como las ventanas del Diseñador de etiquetas y de informes obtienen sus nombres a partir del nombre del archivo que se está creando o modificando.

La ventana Examinar obtiene su nombre a partir del título de la ventana. El nombre y el título de la ventana Examinar se asignan de una de estas tres formas: por la asignación del título predeterminado del alias de la tabla, del título de la ventana (si lo tiene) o del título Examinar (si lo tiene).

De forma predeterminada, el nombre de la ventana Examinar es el alias de la tabla.

Para especificar los nombres de una ventana del sistema y de una barra de herramientas en comandos y funciones, escriba entre comillas el nombre completo de la misma. Por ejemplo, para ocultar la barra de herramientas Controles de informe en Visual FoxPro, ejecute el comando siguiente:

HIDE WINDOW "Report Controls"

Notas adicionales acerca de los nombres de ventanas   Si no sabe con seguridad el nombre asignado a una ventana, recurra al menú Ventana. Todos los nombres de ventanas se muestran en la parte inferior del menú Ventana.

Si ejecuta BROWSE WINDOW WindowName, existirán dos nombres de ventanas. La ventana Examinar es una ventana distinta y toma los atributos de la ventana definida por el usuario especificada. Si una ventana está activa al ejecutar BROWSE y no incluye la cláusula WINDOW, la ventana Examinar tomará los atributos de la ventana activa. Puede anular este comportamiento si incluye NORMAL en BROWSE.

Puede incluir nombres de ventanas que contengan espacios en blanco en comandos y funciones que acepten nombres de ventanas, como MOVE WINDOW, DEACTIVATE WINDOW y WONTOP( ) si especifica la parte del nombre de la ventana que comienza por el primer carácter que no sea un espacio en blanco y termina en el último carácter que no sea un espacio en blanco.

Por ejemplo, una ventana Examinar con el nombre Entrada de facturas puede moverse con este comando:

MOVE WINDOW invoice BY 1,1

Los nombres de las ventanas definidas por el usuario no pueden contener espacios en blanco, pero los nombres de las ventanas Examinar y del sistema sí pueden contenerlos.

Vea también

ACTIVATE WINDOW | DEFINE WINDOW | WEXIST( ) | WLAST( ) | WONTOP( ) | WOUTPUT( ) | WREAD( )