WLROW( ) Function

See Also

Returns the row coordinate of the upper-left corner of the active or specified window.

Syntax

WLROW([WindowName])

Returns

Numeric

Arguments

WindowName

Specifies the window for which WLROW( ) returns the row coordinate. In Visual FoxPro, you can also specify the name of a toolbar. If you omit WindowName, WLROW( ) returns the row coordinate of the active output window. You can also use the empty string for WindowName to specify the main Visual FoxPro window.

In Visual FoxPro, if no window is active, WLROW( ) returns the row coordinate of the main Visual FoxPro window relative to the Windows desktop.

If a system window (the Command window, the Data Session window, a Browse window, and so on) has been opened and is visible or hidden (its name appears on the Window menu), you can include its name in WLROW( ). If you specify the name of a system window that is closed, Visual FoxPro generates an error message. The Debug window is an exception. Once the Debug window has been opened, its name can be included in WLROW( ) if it is visible, hidden, or closed.

Remarks

The value returned by WLROW( ) depends on the current video display mode, and the row coordinate is relative to the main Visual FoxPro window. The display mode can be changed with SET DISPLAY.

Windows can be positioned off the main Visual FoxPro window. If the top of the window is above the main Visual FoxPro window, WLROW( ) returns a negative value. If the top of the window is below the bottom of the main Visual FoxPro window, WLROW( ) returns a positive value greater than the height of the main Visual FoxPro window.