Legacy Document

Inside Macintosh: Macintosh Toolbox Essentials /

Chapter 3 - Menu Manager / Menu Manager Reference

Menu Manager Routines / Managing Entries in the Menu Color Information Table

SetMCEntries

Use the SetMCEntries procedure to set entries in your application's menu color information table. You can set any or all of your application's menu item entries and menu title entries or the menu bar entry.

PROCEDURE SetMCEntries (numEntries: Integer; 
                        menuCEntries: MCTablePtr); 

numEntries

The number of entries contained in the array of menu color entry records.

menuCEntries

A pointer to an array of menu color entry records. Specify the number of records in the array in the numEntries parameter.

DESCRIPTION

The SetMCEntries procedure sets any specified menu bar entry, menu title entry, or menu item entry according to the values specified in the menu color entry records. If
an entry already exists for a specified menu color entry, the SetMCEntries procedure updates the entry in your application's menu color information table with the new values. If the entry doesn't exist, it is added to your application's menu color information table.

If any of the added entries specify a new menu bar color or new menu title colors, your application should call DrawMenuBar to update the menu bar with the new colors.

SPECIAL CONSIDERATIONS

The SetMCEntries procedure may move or purge memory. Your application should make sure that the array specified by the menuCEntries parameter is nonrelocatable before calling SetMCEntries.

SEE ALSO

"The Menu Color Information Table Record" beginning on page 3-100 describes the entries in a menu color information table.