_qres::Enumerate_Sysgui_Forms - Get All Forms for a Given SYSGUI Channel
Syntax
call "_qres::Enumerate_Sysgui_Forms",sysgui,window_list$,status,errmsg$
Description
This routine returns a list of all forms on the SYSGUI channel.
|
Parameter |
Description |
|
sysgui |
The channel that the SYSGUI device is opened on. |
|
window_list$ |
Returns a string that contains a list of the existing windows. Each window will have an entry that contains the window name, the current context, the HTA() of the event mask, and the HTA() of the window flags, in the following format: "WINDOWNAME1" + $00$ + "3" + $00$ + "FFFFFFFF" + $00$ + "00000810" + $0A$ + "WINDOWNAME2" + $00$ + "1" + $00$ + "FFFFFFFF" + $00$ + "00000810" + $0A$ All fields are terminated with a null, and the record is terminated with a $0A$. Windows without names will be formatted as follows: $00$ +"3" + $00$ + "FFFFFFFF" + $00$ + "00000810" + $0A$ + "WINDOWNAME" + $00$ + "1" + $00$ + "FFFFFFFF" + $00$ + "00000810" + $0A$ Above, the window on context 3 does not have a name and the window on context 1 is named WINDOWNAME. |
|
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 (WININFO). An !ERROR=31 may result if the window being evaluated is complex and contains many controls.