_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 records 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$	In the case of unsuccessful operation, this returns a description of the problem encountered.

This routine does not check to see if there is enough memory to get the window information (RESINFO). An error 31 may result in cases where the window being evaluated is very complex and contains many controls.