_qres::Enumerate_Res_Forms - Get All Forms for a Given Resource

Syntax

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

Description

This routine returns a list of all forms on a resource.

Parameter

Description

reshandle

The handle that the target resource is opened on.

resource_list$

Returns a string that contains a list of the top level resources contained in the resource file. Each resource will have an entry that contains the resource name, the window ID, the HTA() of the event mask, and the HTA() of the form flags. In the following format:

"RESOURCENAME1" + $00$ + "10" + $00$ + "FFFFFFFF" + $00$ + "00000810" + $0A$ + "RESOURCENAME2" + $00$ + "20" + $00$ + "FFFFFFFF" + $00$ + "00000810"+ $0A$

All fields are terminated with a null and the record is terminated with a $0A$.

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

See Also

Alphabetical Utilities

Functional Listing of Utilities