xcall MIAMEX, MX_AUTOPARENT, ctrlid

This function allows you to set the default parent control, to apply to subsequent TPRINT/DPRINT and Tab(-1,9) and Tab(-1,10) commands.

Although you can accomplish the same result using the AUI_CONTROL functions and specifying the parent control explicitly, the MX_AUTOPARENT function greatly simplifies dialog coding by allowing you to use the much simpler TPRINT, DPRINT, and Tab(-1,9-10) commands. This is particularly true if SET AUTOTPRINT is used to interpret existing PRINT statements as if they were TPRINT statements.

MX_AUTOPARENT can be used to set the parent to a group box (rather than a dialog), but in this case, only the TPRINT and DPRINT commands are affected.

You should clear the auto parent setting when no longer needed, by calling the routine with ctrlid set to 0. It will also be cleared automatically at the start of a new RUN program.

History

2004 Dec, build 909

Routine added to A-Shell.