Get1IndResource

Get a handle to a resource, given its 1-deep index

#include <Resources.h> Resource Manager

Handle Get1IndResource(rType, index ); [128K ROMs]

ResType rType ; 4-byte ResType; resource type to get

short index ; range: 1 to Count1Resources(...);

returns handle leading to the resource data

Given a resource type and a "1-deep" resource index (an arbitrary value

assigned by the Resource Manager), Get1IndResource reads the resource

from the current resource file into memory and returns a handle for

subsequent access.

rType is a 4-byte ResType value. It identifies the resource type you want

read into memory (e.g., 'FONT', 'WIND', etc.)

index is a positive value greater than or equal to 1. It is a simple index

into an arbitrarily-ordered list of resources in the current file,

maintained by the Resource Manager. The highest valid value for

index can be obtained by calling Count1Resources.

Returns: a handle leading to a resource of type rType . If the return value is

NIL, then an error occurred. Call ResError to figure out what

happened.

Notes: This function is the "1-deep" version of GetIndResource. It obtains

resources only from the current resource file (see UseResFile) By

calling this repeatedly over the entire range of index, you can obtain

handles to all resources of type rType in the current resource file.

Use Count1Resources( rType ) to determine the valid range for index .

Refer to GetIndResource and CountResources for related details and

cautions.

Referenced by (25):