? tab(-10, AG_CONTROL), opcode, ctlid, ctext, cstate, ctype, cmd, func, srow, scol, erow, ecol, fgc, bgc, fontattr, fontscale, fontface, tooltip, parentid, rtnflag, winclass, winstyle, winstylex, ctype2; chr(127);
AG_CONTROL (20) is the equivalent of AUI_CONTROL and MX_WINCTL. It is used internally for forwarding those functions from A-Shell/UNIX to ATE, although it also can be used directly with an application to create, delete, or perform various other operations on GUI controls.
The number of required parameters depends on the opcode; see AUI_CONTROL for details and additional information.
To output an explicit double-quote character in the middle of a field, you can "escape" it using HTML syntax, by %22 (a percent sign followed by the value of the character in hex notation). AUI_CONTROL haandles this for you—yet another reason to use it instead of AG_CONTROL.
Parameters
Nearly all of the parameters correspond to those already documented for th AUI_Control routine. The only exceptions are the removal of the AUI_CONTROL cstatus parameter (which is output-only and thus has no purpose in the command string sent to the client), and the addition of:
rtnflag
"1" causes the function to return a string of result information in the keyboard buffer. Otherwise there is no response.
Example
? TAB(-10,AG_CONTROL);"1,0,OK,0,";MBF'BUTTON;",%VK_xF101%,",12,5,13,10";chr(127);
? TAB(-10,AG_CONTROL);"1,,Dr A~VK_xF1001~~Dr B...";chr(127);
xcall NOECHO
input STATUS,CTLID
See Also