![]() |
ATSUGetTextLocation |
||||
Header: | ATSUnicode.h | Carbon status: | Supported | |
Determines the location of text in physical memory, the length of the range of text and text buffer, and whether the text is accessed by a pointer or handle.
OSStatus ATSUGetTextLocation ( ATSUTextLayout iTextLayout, void **oText, Boolean *oTextIsStoredInHandle, UniCharArrayOffset *oOffset, UniCharCount *oTextLength, UniCharCount *oTextTotalLength );
A reference to an initialized text layout object containing text whose text location in physical memory you wish to determine. You cannot pass NULL for this parameter.
A pointer or handle to the beginning of the text buffer whose text location in physical memory you wish to determine. If the value passed back in the oTextIsStoredInHandle parameter is true, on return, this parameter contains a handle to the beginning of the text buffer. If false, on return, this parameter contains a pointer to the beginning of the text buffer.
On return, a pointer to a value that indicates whether the text buffer in the oText parameter is accessed by a handle or pointer. If true, the text buffer is accessed by handle; if false, the text buffer is accessed by pointer.
On return, a pointer to the edge offset in backing store memory that corresponds to the beginning of range of text whose text location in physical memory you wish to determine.
On return, a pointer to the length of the range of text whose text location in physical memory you wish to determine.
On return, a pointer to the length of the entire text buffer whose text location in physical memory you wish to determine.
A result code.
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)