GUIBuilder: _qres::Enumerate_Res_Popups - Get All Popup Menus for a Given Resource (Superseded)

GUIBuilder has been superseded by the AppBuilder module in the BASIS IDE for BBj. Includes support for both the READRECORD Event Queue and PROCESS_EVENTS/CALLBACK paradigm. Integrates tightly with FormBuilder, the BBj replacement for ResBuilder.

Syntax

call "_qres::Enumerate_Res_Popups",reshandle,resource_list$,status,errmsg$

Description

In BBj 4.00 and higher, this routine returns a list of all popup menus in a resource.

Parameter

Description

reshandle

The handle on which the target resource is opened.

resource_list$

Returns a string that contains a list of the popup menus contained in the resource file. Each popup menu will have an entry that contains the resource name and the popup menu ID in the following format:

"POPUPMENU1" + $00$ + "1001" + $0A$ +
"POPUPMENU2" + $00$ + "1002" + $0A$

All fields are separated by a null and each record is terminated with a $0A$.

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 resource information (RESINFO). An error 31 may result in cases where the resource being evaluated is very complex and contains many controls.