GetNamedResource

Read a named resource; get its handle

#include <Resources.h> Resource Manager

ResType rType ; resource type, e.g., 'FONT'

ConstStr255Param rName ; address of length-prefixed text (e.g., "\pgeneva")

returns a handle leading to some resource data

This works just like GetResource, except that instead of a resource ID, you

specify a resource name.

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

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

rName is the address of a Pascal-style length-prefixed string. It must

match the name in the resource file except that character case is not

significant (e.g., "MyMdef" matches "mymdef" or "MYMDEF").

Returns: a handle leading to the resource data. A return value of NIL indicates

an error - either the resource can not be found or it will not fit into

memory. See ResError.

Notes: Please refer to GetResource for detailed information. Resources need not

be named and, in fact, most system resources have no name and most

applications simply use resource IDs. You may find it is more

self- documenting to use names, e.g.:

Cursor pbCursor;

pbCurH=(CursHandle)GetNamedResource('CURS',"\pPaintBrush");

pbCursor = **pbCurH; [TOKEN:12074]make a copy */

SetCursor( &pbCursor );

Referenced by (24):