_qres::Enumerate_Res_Child_Windows - Get All Child Windows for a Given Top Level Window

Syntax

call "_qres::Enumerate_Res_Child_Windows",reshandle,resource_id,child_list$,
status,errmsg$

Description

This routine returns a list of all child windows on a top-level window 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 the child windows on the given top level window. Each window will have an entry that contains the window name, window ID (genealogy), context (always -1) for compatibility with Enumerate_Sysgui_Child_Windows, the HTA() of the window's event mask, and the HTA() of the window's flags, in the following format:

"WINDOWNAME1" + $00$ + "10.20" + $00$ + "-1" + $00$ + "FFFFFFFF" + $00$ + "00000810" + $0A$ + "WINDOWNAME2" + $00$ + "10.20.30" + "-1" + $00$ + "FFFFFFFF" + $00$ + "00000810" + $0A$

All fields are terminated with null and the record is terminated with a $0A$. The above example shows a child window called WINDOWNAME1 that is control ID 20 on top level window (form) 10, and a child window called WINDOWNAME2 that is control ID 30 on a child window that is control ID 20 on the top level window (form) 10.

status

Returns 1 for successful operation and 0 for unsuccessful operation.

errmsg$

Returns a description of the problems encountered.

This routine does not check for enough memory to get the window information (RESINFO). An !ERROR=31 may result in cases where the window being evaluated is complex and contains many controls.

See Also

Alphabetical Utilities

Functional Listing of Utilities