Legacy Document

Inside Macintosh: Text /

Chapter 6 - Script Manager / Script Manager Reference

Routines / Directly Accessing International Resources

GetIntlResource

The GetIntlResource function returns a handle to one of the following international resources: numeric-format ('itl0'), long-date-format ('itl1'), string-manipulation ('itl2'), tokens ('itl4'), or encoding/rendering ('itl5'). GetIntlResource selects the resource of the requested type for the current script.

FUNCTION GetIntlResource (theID: Integer) :Handle;

theID

Contains an integer (0, 1, 2, 4, or 5 respectively for the 'itl0', 'itl1', 'itl2', 'itl4', and 'itl5'resources) to identify the type of the desired international resource.

DESCRIPTION

The GetIntlResource function returns a handle to the correct resource of the requested type. The resource returned is that of the current script, which is either the font script or the system script. See "Determining Script Codes From Font Information" on page 6-21.

If GetIntlResource cannot return the requested resource, it returns a NIL handle and sets the global variable resErr to the appropriate error code.

SPECIAL CONSIDERATIONS

GetIntlResource may move memory; your application should not call this function at interrupt time.

SEE ALSO

See the Resource Manager chapter in Inside Macintosh: More Macintosh Toolbox for information on resErr and how to get its value.