# AG\_SHOWWINDOW

> [HTML Version](ag_showwindow.htm)

_Rewritten December 2023_

**tab(-10, AG\_SHOWWINDOW); opflag, lft, top, rgt, btm, rows, cols, tsts, bsts, rtnflg, cid; chr(127);**     [Tab(-10,x) Syntax Notes](ag_xxx_syntax-notes.htm.md)

AG\_SHOWWINDOW (27) performs the same function as the subroutine [AUI\_WINDOW](aui_window.htm.md)[xs](keyword-types.htm.md), which see for the parameter descriptions, in addition to the differences noted below. 

**Parameters**

_opflag_

In addition to the numeric values listed under AUI\_WINDOW, may also be one of the following:

| **Char** | **Description** |
|------|------|
| M | SW\_MINIMIZE |
| X | SW\_SHOWMAXIMIZED |
| R | SW\_RESTORE |
| N | SW\_SHOWNORMAL |




_rtnflg_

Must be set to >= 1 to receive any response.  If >= 2, the  number of monitors will be appended to the response list.  If >= 3, the windows status will also be appended.  Note that setting the _rtnflg_ >0 only really makes sense if _opflag_ is <0 (query operations).

**Response**

Unless _rtnflg_ > 0, none.

For _rtnflg_ = 1: 

_vleft, vtop, vright, vbottom, rows, cols, tsts, bsts, hg, vg_ CR

_For rtnflg = 2:_

_vleft, vtop, vright, vbottom, rows, cols, tsts, bsts, hg, vg ,monitors_ CR

For _rtnflg_ >= 3:

_vleft, vtop, vright, vbottom, rows, cols, tsts, bsts,hg, vg, monitors, winsts_ CR

These are all the same output values returned by AUI\_WINDOW, which see for details.

**Examples**

\! minimize 

? tab(-10,AG\_SHOWWINDOW); "M"; chr(127);

\! maximize

? tab(-10,AG\_SHOWWINDOW); "X"; chr(127);



\! modify display attributes of dialog "dlgSample"

writecd tab(-10,AG\_SHOWWINDOW); SW\_SHOWNORMAL, lft, top, rgt, btm, rows, cols, tsts, bsts, 0, "dlgSample"; chr(127);



\! query window information

writecd tab(-10,AG\_SHOWWINDOW); SW\_QRYCTLPIX,0,0,0,0,0,0,0,0,1; chr(127);

input "", lft, top, rgt, btm, rows, cols, tsts, bsts, hg, vg



\! query monitor information

writecd tab(-10,AG\_SHOWWINDOW); SW\_QRYMON,0,0,0,0,0,0,0,0,2; chr(127);

input "", lft, top, rgt, btm, dummy, dummy, dummy, dummy, xres, yres, monitors



**See Also**

•	[AUI\_WINDOW](aui_window.htm.md)[xs](keyword-types.htm.md)