LOADSTRINGS Procedure
Loads strings from a resource file.
Usage
LOADSTRINGS, file
Input Parameters
file—The name of the string resource file to be loaded.
Keywords
Appdir—A string that specifies the application directory name. This is the directory in which the application searches for resource files, string resource files, and icon files. (Default: 'vdatools')
Subdir—Specifies a subdirectory in which to look for the resource file. (Default: !Lang, whose default is 'american')
Discussion
By default, the function looks for file first in directories specified by the environment variable WAVE_RESPATH.
note | For UNIX, the WAVE_RESPATH environment variable is a colon-separated list of directories, similar to the WAVE_PATH environment variable in PV‑WAVE. If not found in a WAVE_RESPATH directory, the directory <wavedir>/xres/!Lang/vdatools is searched, where <wavedir> is the main PV‑WAVE directory and !Lang represents the value of the !Lang system variable (!Lang default is 'american'). |
note | For Windows, the WAVE_RESPATH environment variable is a semicolon-separated list of directories, similar to the WAVE_PATH environment variable in PV‑WAVE. If not found in a WAVE_RESPATH directory, the directory <wavedir>\xres\!Lang\vdatools is searched, where <wavedir> is the main PV‑WAVE directory and !Lang represents the value of the !Lang system variable (!Lang default is 'american'). |
If Subdir alone is specified, the file is searched for in:
(UNIX) <wavedir>/xres/subdir/vdatools
(WIN) <wavedir>\xres\subdir\vdatools
Where <wavedir> is the main PV-WAVE directory.
If only Appdir is specified, the application searches for resources in the following directory:
(UNIX) <wavedir>/xres/!Lang/appdir
(WIN) <wavedir>\xres\!Lang\appdir
Where <wavedir> is the main PV-WAVE directory.
If both Subdir and Appdir are specified, the application searches for resources in the following directory:
(UNIX) <wavedir>/xres/subdir/appdir
(WIN) <wavedir>\xres\subdir\appdir
Where <wavedir> is the main PV-WAVE directory.
If the file to be loaded is not already in the resource database, it is loaded and added to the resource database list of files.
This procedure functions as a wrapper to the LOADRESOURCES procedure with the Strings keyword set.
Example
These calls load resources and strings for a Printer Setup dialog box. This example assumes that the resource and string files are located in:
(UNIX) <wavedir>/xres/american/vdatools
(WIN) <wavedir>\xres\american\vdatools
Where <wavedir> is the main PV-WAVE directory.
; Load resources and strings.
LOADRESOURCES, 'printsetup.ad'
LOADSTRINGS, 'printsetup.ads'
See Also
Version 2017.1
Copyright © 2019, Rogue Wave Software, Inc. All Rights Reserved.