_qres::Enumerate_Res_Controls - Get All Child Windows for a Given Form

Syntax

call "_qres::Enumerate_Res_Controls",reshandle,resource_id,
control_list$,status,errmsg$

Description

This routine returns a list of all controls on the specified form in a resource.

Parameter

Description

reshandle

The handle that the target resource is opened on.

resource_id

The ID of a top level window on which to look for children.

child_list$

Returns a string that contains a list of all the controls on the specific top level window. Each control will have an entry that contains the type of control (as specified in CTRL(4)), window ID, control name, control ID, and x, y, w, h. Each control segment is formatted with the following template:

Temp$="Type:n(2*=0),Window_id:c(16*=0),Name:C(30*=0),Ctl_id:C(3*=0),x:n(3*=0),
y:n(3*=0),w:n(3*=0),h:n(3*=10)"

All fields are terminated with null, and the height field (h) is terminated with a $0A$. If the given control has an ID of "2001" and is on a child window that is control ID "200" on the top level window that has a window ID of "10", the Ctl_id field will contain "2001", and the Window_id field will contain the complete genealogy of the controls container, "10.200."

status

Returns 1 for successful operation and 0 for unsuccessful operation.

errmsg$

Returns a description of the problems encountered.

See Also

Alphabetical Utilities

Functional Listing of Utilities