![]() |
ATSUCreateTextLayout |
||||
Header: | ATSUnicode.h | Carbon status: | Supported | |
Creates an empty text layout object.
OSStatus ATSUCreateTextLayout ( ATSUTextLayout *oTextLayout );
On return, a pointer to a reference to a newly-created text layout object.
A result code.
The ATSUCreateTextLayout function creates a text layout object containing only default text layout attribute values, described in
Most ATSUI functions that operate on text layout objects require that they contain style runs and text. If you create an empty text layout object and then wish to associate style runs or text with it, call the functions ATSUSetRunStyle and ATSUSetTextPointerLocation or ATSUSetTextHandleLocation, depending upon whether you wish to assign text referenced by a handle or a pointer.
ATSUCreateTextLayout allocates 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)