parentid

(Integer) If specified when creating a new control, the new control becomes a child of the specified control. This has two primary ramifications: 1) the coordinates of the child control are taken to be relative to the client area of the parent, and 2) such child controls will be automatically deleted when the parent is deleted or cleared. (If a dialog box is currently displayed, then the parentid of any new controls is automatically set to the current dialog box.)

Parentid, like ctlid, may also be expressed as an alphanumeric string. See ctlid for further notes, and also see Control names.

History

2006 July, A-Shell 4.9.961:  Dialogs created with AUI_CONTROL may now specify a parent ID of -1 to signify that the dialog is a child of the main window. The default (0) makes the new dialog a child of the current dialog, if any.