Documentation
Retrieves a generic string option from the resource database.
The string option is identified by two names: the object name and
the option name. Both names are free, the application can retrieve string
options manually defined in the application or the MGUI resource files or
stored (in the application resource file) via MSaveOptions.
- Returns:
- The string value is returned in a new allocated buffer. The application is
responsible for freeing the memory, using free(), when the value is no
longer needed. The NULL pointer is returned if the option is not found.
- Parameters:
- obj_name -
Specifies the name of the object. An object in the DOS and Windows
resource file is defined by enclosing its name in brackets and it is
followed by option definitions.
opt_name -
Specifies the name of the option. Option names in the DOS and
Windows resource file appear after an object definition. The option
is followed by the '=' character and the option value.
- See Also:
- MSetStringOption
alphabetic index hierarchy of classes