GetString

Get handle of a string from a resource

#include <ToolUtils.h> Toolbox Utilities

short stringID ; resource Identifier of string to get

returns a handle leading to a Pascal string; 0 (NIL) if error

This finds a string in a resource and returns a handle leading to its data.

stringID is the identifier of a string in an 'STR ' resource.

Returns: a handle to a Pascal string. If the specified resource ID can't be

found, the return value is 0 (NIL).

Notes: This is a quick alternative to:

GetResource( 'STR ', stringID );

The size of the storage for the returned handle is based on the actual size of

the string, as indicated by its length byte. If you intend to manipulate the

data as a Pascal string , you should use SetHandleSize to expand the

storage to its potential maximum of 256 bytes.

Applications that use a large number of strings may prefer to use resource

indexing. See GetIndString.

Referenced by (9):