Apple PowerBook 520 Technical Information download pdf (Page 102)

CHAPTER 5

Software

88 Control Strip Module Reference

SBOpenModuleResourceFile 5

You can use the SBOpenModuleResourceFile routine to open a module resource ﬁle.

pascal short SBOpenModuleResourceFile(OSType fileCreator);

The SBOpenModuleResourceFile routine opens the resource fork of the module

ﬁle whose creator is fileCreator, and return the ﬁle’s reference number as its result.

If the ﬁle cannot be found or opened, SBOpenModuleResourceFile returns a result

of –1.

SBOpenModuleResourceFile provides a means for a module to load in large or

infrequently used resources that it doesn’t usually need, but that it requires for a

particular operation.

SBLoadPreferences 5

You can use the SBLoadPreferences routine to load a resource from a preferences ﬁle.

pascal OSErr SBLoadPreferences(ConstStr255Param prefsResourceName,

Handle *preferences);

The SBLoadPreferences routine loads a resource containing a module’s conﬁguration

information from the control strip’s preferences ﬁle. The PrefsResourceName

parameter points to a Pascal string containing the name of the resource. The

Preferences parameter points to a variable that will hold a handle to the resource read

from the ﬁle. The handle does not need to be preallocated.

If either prefsResourceName or preferences contains a nil pointer,

SBLoadPreferences does nothing and returns a result of paramErr. If the resource is

successfully loaded, it returns a result of 0. SBLoadPreferences can also return other

Memory Manager and Resource Manager errors if it fails during some part of the

process.

SBSavePreferences 5

You can use the SBSavePreferences routine to save a resource to a preferences ﬁle.

pascal OSErr SBSavePreferences(ConstStr255Param prefsResourceName,

Handle preferences);

The SBSavePreferences routine saves a resource containing a module’s conﬁguration

information to the control strip’s preferences ﬁle. The PrefsResourceName parameter

1 2 ... 97 98 99 100 101 102 103 104 105 106 107 ... 143 144

No comments

Apple PowerBook 520 Technical Information Page 102