![]() |
ATSUUnderwriteAttributes |
||||
Header: | ATSUnicode.h | Carbon status: | Supported | |
Copies style run attributes, font features, and font variations set in the source but not in the destination style object.
OSStatus ATSUUnderwriteAttributes ( ATSUStyle iSourceStyle, ATSUStyle iDestinationStyle );
A reference to a style object whose previously set style run attribute, font feature, and font variation values you want to copy. Note that only those previously set values that are unset in the destination style object will be copied. You cannot pass NULL for this parameter.
A reference to a style object whose corresponding values you want to replace. You cannot pass NULL for this parameter.
A result code.
The ATSUUnderwriteAttributes function copies all values other than defaults from a style object if the corresponding values are not set in the destination style object. Unlike the function ATSUOverwriteAttributes, the corresponding values in the destination object must be unset in order for the copy to work. All other quantities in the destination style object are left unchanged.
ATSUUnderwriteAttributes does not copy the contents of memory referenced by pointers or handles within custom style run attributes or within reference constants. You are responsible for ensuring that this memory remains valid until the source style object is disposed of.
If you wish to create a style object that contains the contents of another style object, call the function ATSUCreateAndCopyStyle. To copy the contents of a style object into an existing style object, call the function ATSUCopyAttributes. To copy style run attributes, font features, and font variations previously set in the source into the destination style object, call the function ATSUOverwriteAttributes.
ATSUUnderwriteAttributes may allocate memory in your application heap, unless you designate a different heap by calling the function ATSUCreateMemorySetting.
Available beginning with ATSUI 1.0.
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)