Carbon


TXNNewFontMenuObject

Header: MacTextEditor.h Carbon status: Supported

Creates a new font menu object.

OSStatus TXNNewFontMenuObject (
    MenuRef iFontMenuHandle, 
    SInt16 iMenuID, 
    SInt16 iStartHierMenuID, 
    TXNFontMenuObject *oTXNFontMenuObject
);
Parameter descriptions
iFontMenuHandle

A variable of type MenuHandle. This is a handle you obtain from the Menu Manager and that specifies the title of the menu. You must make sure the string is localized appropriately.

iMenuID

A 16-bit integer that specifies the menu ID of the Font menu.

iStartHierMenuID

A 16-bit integer that specifies the menu ID at which hierarchical menus begin. Hierarchical menus are created on systems that use Apple Type Services for Unicode Imaging (ATSUI).

oTXNFontMenuObject

A pointer to a variable of type TXNFontMenuObject. On return, a new font menu object.

function result

A result code.

DISCUSSION

A good time to call the TXNNewFontMenuObject function is when you are preparing to display your menu bar. When you pass a Font menu to a text object, MLTE fills in the menu with Fonts and handles all aspects of user interaction with the Font menu.

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)