Carbon


ATSUCreateStyle

Header: ATSUnicode.h Carbon status: Supported

Creates a style object.

OSStatus ATSUCreateStyle (
    ATSUStyle *oStyle
);
Parameter descriptions
oStyle

On return, a pointer to a reference to a newly-created style object. The style object you create contains default style run attribute, font feature, and font variation values. You cannot pass NULL for this parameter.

function result

A result code.

DISCUSSION

The ATSUCreateStyle function creates an “empty” style object that contains unset style run attribute, font feature, and font variation values. Unset font feature and variation values are assigned default values defined by the font; unset style run attribute values are assigned default values described in “Style Run Attribute Tag Constants”.

To set style run attribute values for your empty style object, call the function ATSUSetAttributes. To set font features and font variations, call the functions ATSUSetFontFeatures and ATSUSetVariations, respectively. To create a new style object that contains the contents of another style object, call the function ATSUCreateAndCopyStyle.

ATSUCreateStyle allocates memory in your application heap, unless you designate a different heap by calling the function ATSUCreateMemorySetting.

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)