![]() |
ATSUGetAllLayoutControls |
||||
Header: | ATSUnicode.h | Carbon status: | Supported | |
Obtains attribute information from a text layout object.
OSStatus ATSUGetAllLayoutControls ( ATSUTextLayout iLayout, ATSUAttributeInfo oAttributeInfoArray[], ItemCount iTagValuePairArraySize, ItemCount *oTagValuePairCount );
A reference to an initialized text layout object whose attribute information you want to obtain. You cannot pass NULL for this parameter.
An array of attribute tag/value size pairs. Before calling ATSUGetAllAttributes, pass a pointer to memory that you have allocated for this array. If you are uncertain of how much memory to allocate, see the discussion below. On return, an array of the tag and value size pairs corresponding to all previously set text layout attribute values in the text layout object.
The maximum number of tag and value size pairs in the text layout object. Typically, this is equivalent to the number of ATSUAttributeInfo structures in the oAttributeInfoArray array. To determine this value, see the discussion below.
On return, a pointer to the actual number of ATSUAttributeInfo structures in the text layout object. This may be greater than the value you specified in the iTagValuePairArraySize parameter. You cannot pass NULL for this parameter.
A result code.
The ATSUGetAllLayoutControls function determines all previously set text layout attributes contained in a text layout object. You can pass a tag and value size pair that ATSUGetAllLayoutControls passes back as an element of the oAttributeInfoArray array to the function ATSUGetLayoutControl to determine the corresponding attribute value. The best way to use ATSUGetAllLayoutControls is to call it twice:
To determine all previously set text layout attributes contained in a single line of a text layout object, call the function ATSUGetAllLineControls.
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)