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_SHOWWINDOW (27) performs the same function as the subroutine AUI_WINDOW, 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