_qres::Enumerate_Sysgui_Forms - Get All Forms for a Given SYSGUI Channel

Syntax

call "_qres::Enumerate_Sysgui_Forms",gb__sysgui,window_list$,status,errmsg$

Description

This routine returns a list of all forms on the SYSGUI channel.

Parameter	Description
gb__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 with no 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 has no name and the window on context 1 is named WINDOWNAME.
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 (WININFO). An error 31 may result in cases where the window being evaluated is very complex and contains many controls.