Carbon


ATSUSetStyleRefCon

Header: ATSUnicode.h Carbon status: Supported

Sets application-specific data for a style object.

OSStatus ATSUSetStyleRefCon (
    ATSUStyle iStyle, 
    UInt32 iRefCon
);
Parameter descriptions
iStyle

A reference to a style object whose application-specific data you want to set. You cannot pass NULL for this parameter.

iRefCon

A 32-bit value, pointer, or handle to application-specific style data.

function result

A result code.

DISCUSSION

The ATSUSetStyleRefCon function enables you to associate application-specific data with a style object. If you copy or clear a style object that contains a reference constant, the reference constant will not be copied or removed. When you dispose of a style object that contains a reference constant, you are responsible for freeing any memory allocated for the reference constant. Calling the function ATSUDisposeStyle will not do so.

VERSION NOTES

Available beginning with ATSUI 1.0.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.5 or later.


© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)