+---------------------------------+
|              WLROW              |
+---------------------------------+
WLROW([<window name>])

-----------------------------------
Returns screen row location of a window.
Return value - Numeric
-----------------------------------

WLROW() returns the row location of the upper border of a window.  The
row location is always relative to the screen.

Note that the value returned by WLROW() is dependent on the current
video display mode.  The display mode may be changed with SET DISPLAY.
Also note that windows may be positioned off the screen.  In this case,
negative values are returned by WLROW() if the window is above the top
of the screen, and values greater than the screen height are returned if
the window's upper border is below the bottom of the screen.

<window name>
        If a <window name> isn't included, the row location of the upper border
of the active output window is returned.  If a window isn't active, the
row location of the screen is returned.  This is always 0.

        Note that the null string may be used to specify the screen in
functions that return window locations or sizes (WLCOL(), WLROW(),
WCOLS(), WROWS(), etc.).  The screen, which underlies all System and
user-defined windows, is sometimes called the desktop.

        If you include a <window name> in WLROW(), the row location of the
upper border of the specified window is returned.  WLROW() may be used
to return the row location of the upper border of a FoxPro system
window.

        If a FoxPro system window (the Command window, the View window, ASCII
Chart, a Browse window ... ) has been opened and is visible or is hidden
(its name appears in the Window menu), you may include its name in
WLROW().  If you include the name of a FoxPro system window that is
closed, the alert "WINDOW has not been defined." is displayed.  The
Debug window is an exception.  Once the Debug window has been opened,
its name be may included in WLROW() if it is visible, hidden or closed.

-----------------------------------

See Also:  WCOLS(), WLCOL(), WROWS()

-----------------------------------