Carbon


ATSUClearStyle

Header: ATSUnicode.h Carbon status: Supported

Removes all values other than the defaults from a style object.

OSStatus ATSUClearStyle (
    ATSUStyle iStyle
);
Parameter descriptions
iStyle

A reference to a style object whose nondefault style run attributes, font features, and font variations you wish to remove. You cannot pass NULL for this parameter.

function result

A result code.

DISCUSSION

The ATSUClearStyle function restores all style run attributes (including application-defined attributes), font features, and font variations to their default values. Default font variations and font features are defined by the font; default style run attribute values are described in “Style Run Attribute Tag Constants”. ATSUClearStyle does not remove reference constants.

To remove style run attributes from a style object, call the function ATSUClearAttributes. To remove font variations from a style object, call the function ATSUClearFontVariations. To remove font features from a style object, call the function ATSUClearFontFeatures.

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)