version 6.0
Get resource properties (resType; resID{; resFile}) Number
Parameter | Type | Description | |
resType | String | 4-character resource type | |
resID | Number | Resource ID number | |
resFile | DocRef | Resource file reference number, or | |
all open resource files, if omitted | |||
Function result | Number | Resource attributes |
Description
The Get resource properties command returns the attributes of the resource whose type is passed in resType and whose ID number is passed in resID.
If you pass a valid resource file reference number in the parameter resFile, the resource is searched for within that file only. If you do not pass the parameter resFile, the resource is searched for within the current open resource files.
If the resource does not exist, Get resource properties returns 0 (zero) and sets the OK variable to 0 (zero).
The numeric value returned by Get resource properties must be seen as a bit field value whose bits have special meaning. For a description of the resource attributes and their effects, please refer to the command SET RESOURCE PROPERTIES.
Example
See example for the command Get resource name.
See Also
System Variables or Sets
The OK variable is set to 0 if the resource does not exist; otherwise, it is set to 1.