Carbon


TXNDisposeFontMenuObject

Header: MacTextEditor.h Carbon status: Supported

Disposes a Font menu object.

OSStatus TXNDisposeFontMenuObject (
    TXNFontMenuObject iTXNFontMenuObject
);
Parameter descriptions
iTXNFontMenuObject

A variable of type TXNFontMenuObject. Pass the Font menu object to be disposed. You obtain a Font menu object from TXNNewFontMenuObject.

function result

A result code.

DISCUSSION

The TXNDisposeFontMenuObject function releases the specified Font menu object from memory. Note that TXNDisposeFontMenuObject does not dispose of the main font menu handle that is associated with the Font menu object. You are responsible for disposing of the Font menu handle after calling TXNDisposeFontMenuObject. However, TXNDisposeFontMenuObject does dispose of any sub-menus that MLTE creates to support Apple Type Services for Unicode Imaging (ATSU) fonts.

A good time to call the TXNDisposeFontMenuObject function is when your application quits (that is usually when you would be done with the Font menu). You can dispose of the Font menu object as part of a “terminate” function you create to do clean-up and terminate tasks.

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)