Compartir a través de

WCOLS( ) (Función)

  • Artículo

Devuelve el número de columnas de la ventana activa o de la ventana especificada.

WCOLS([WindowName])

Valores devueltos

Numeric

Parámetros

  • WindowName
    Especifica la ventana cuyo número de columnas devuelve WCOLS( ). En Visual FoxPro, también puede especificar el nombre de una barra de herramientas. Si no especifica ninguna ventana, se devuelve el número de columnas de la ventana de resultado activa. Si no hay ninguna ventana activa, WCOLS( ) devuelve el número de columnas de la ventana principal de Visual FoxPro.

    Puede especificar el nombre de una ventana del sistema (la ventana Comandos, la ventana Sesión de datos, una ventana Examinar, etc.) en WCOLS( ) si la ventana del sistema se ha activado y está visible u oculta. En Visual FoxPro, puede especificar el nombre de una barra de herramientas (Estándar, Paleta de colores, etc.) con WCOLS( ) si dicha barra de herramientas se ha activado y está visible u oculta. Si especifica el nombre de una ventana de sistema o de una barra de herramientas que no se ha activado, Visual FoxPro genera un mensaje de error. La ventana Depuración es una excepción. Una vez abierta la ventana Depuración, su nombre se puede incluir con WCOLS( ) si está visible, oculta o cerrada.

    También puede incluir la cadena vacía como el nombre de ventana para devolver el número de columnas de la ventana principal de Visual FoxPro.

    Puede utilizar la cadena vacía para especificar la ventana principal de Visual FoxPro en funciones que devuelven ubicaciones o tamaños de ventanas, como WLCOL( ), WLROW( ) y WROWS( ).

Observaciones

En Visual FoxPro, el valor devuelto por WCOLS( ) depende de la fuente especificada para la ventana. Muchas fuentes se pueden mostrar en gran variedad de tamaños y algunas tienen un espacio proporcional. Una columna corresponde al ancho medio de una letra en la fuente actual. Para obtener más información, vea Introducción a las fuentes.

Ejemplo

En el ejemplo siguiente se centra un mensaje de resultado corto en la última fila de una ventana de tamaño desconocido.

CLEAR
DO SendMesg WITH 'Message', WCOLS( ), WROWS( ) –1

** SendMesg **

PROCEDURE SendMesg
PARAMETERS gcMsg, gnCol, gnRow
STORE (gnCol – LEN(gcMsg))/2 TO gnCol
@ gnRow, gnCol SAY gcMsg
RETURN

Vea también

SCOLS( ) | SROWS( ) | WLCOL( ) | WLROW( ) | WROWS( ) | Introducción a las fuentes