GetPattern

Get handle to a specified 'PAT ' resource

#include <ToolUtils.h> Toolbox Utilities

PatHandle GetPattern(patID );

short patID ; resource ID for desired pattern

returns handle leading to an 8-byte Pattern ; 0 if error

GetPattern searches the resource list until it finds the specified pattern. It

reads the resource from disk (if necessary) and returns a handle to a 8-byte

Pattern structure.

patID is the resource identifier of the desired pattern.

Returns: a 32-bit Handle leading to the pattern data. If the resource ID patID

can't be found, the return value is NIL.

Notes: This function is typically used to get a pattern from the caller's application

resource. It is functionally equivalent to:

patHand = GetResource('PAT ', patID );

To get access to one of the 38 predefined system patterns, use

GetIndPattern. Other common patterns are available as Quickdraw

global variables with the following names, identified in Quickdraw.h and

defined in the MacTraps library:

A5-8

black

A5-16

gray

A5-24

ltGray

A5-32

dkGray

A5-40

See PenPat for related information. See Standard Patterns for a look at

other patterns made available by the system.

Referenced by (9):