![]() |
TEGetStyleScrapHandle |
||||
Header: | TextEdit.h | Carbon status: | Not Recommended | |
Creates a style scrap structure, copies the character attributes associated with the current selection range into it, and returns a handle to it.
StScrpHandle TEGetStyleScrapHandle ( TEHandle hTE );
The handle to the edit structure containing the text selection range whose character attributes are to be copied.
A handle to the created style scrap structure, or NULL if called with a handle to a monostyled structure.
The TEGetStyleScrapHandle function creates a style scrap structure of type StScrpRec and copies the character attributes associated with the current selection range of the designated edit structure into it. If the current selection range is an insertion point, TEGetStyleScrapHandle first checks the null scrap. If the null scrap contains character attributes, they are written to the newly created style scrap structure. If the null scrap is empty, the attributes associated with the character preceding the insertion point are copied to the style scrap structure.
The TEGetStyleScrapHandle function has no impact on the Scrap Managers desk scrap.
Not recommended in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.
© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)