Syntax
RESGET(handle,group,item{,ERR=lineref})
Description
For BBj-specific information, see the RESGET()
Function - BBj.
RESGET() returns a resource string from a BASIS resource file.
|
Parameter |
Description |
|
handle |
Handle returned by the RESOPEN() function. |
|
group |
Resource type,
as follows: |
|
item |
Resource ID, which must be an integer between 0 and 32767. |
|
ERR=lineref |
Branch to be taken if an error occurs during execution. |
The resource string can be up to 32767 bytes long, and can be printed to the SYSGUI device to display a window or a dialog, as defined in the resource file. In Visual PRO/5 2.x, resource strings returned by RESGET() can include information about menus, child windows, and image lists, as well as windows.
Example
0010 LET HANDLE=RESOPEN("RESOURCE.BRC")
0020 LET A$=RESGET(HANDLE,1,101); REM Retrieves
0020:window/dialog #1, item 1 from the resource file
0030 LET CHAN=UNT; OPEN (CHAN)"X0"; REM Open the SYSGUI device
0040 PRINT (CHAN)'RESOURCE'(LEN(A$)),A$; REM Display the dialog
0050 RESCLOSE(HANDLE)