Carbon


TXNConvertToPublicScrap

Header: MacTextEditor.h Carbon status: Supported

Converts the private MLTE scrap content to the Clipboard.

OSStatus TXNConvertToPublicScrap ();
function result

A result code. TXNConvertToPublicScrap returns errors from the Memory Manager and Scrap Manager, as well as noErr.

DISCUSSION

You should call TXNConvertToPublicScrap whenever another application might access the Clipboard—typically, upon receiving a suspend event or before displaying a dialog box that supports cut and paste. Calling TXNConvertToPublicScrap ensures that whatever data the user has placed in the scrap while working within an MLTE text area is available to other applications.

The public formats that MLTE directly supports are plain text, styled text, plain Unicode text, styled Unicode text, QuickTime movies, sound, and pictures.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.


© 2000 Apple Computer, Inc. (Last Updated 7/17/2000)