Manager: Menu Manager


Carbon supports the Menu Manager, with the following changes:

Supported  AcquireRootMenu

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  AppendMenu

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Unsupported  appendmenu

Use AppendMenu instead. Not available in CarbonLib. Not available in Mac OS X.

Supported  AppendMenuItemText

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Supported  AppendMenuItemTextWithCFString

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  AppendResMenu

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  CalcMenuSize

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  ChangeMenuAttributes

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  ChangeMenuItemAttributes

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  ChangeMenuItemPropertyAttributes

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Unsupported  CheckItem

CheckItem has been renamed to CheckMenuItem in Carbon. Not available in CarbonLib. Not available in Mac OS X.

Supported  CheckMenuItem

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  ClearMenuBar

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  CMPluginExamineContext

Supported  CMPluginHandleSelection

Supported  CMPluginPostMenuCleanup

Supported  ContextualMenuSelect

Available in CarbonLib 1.0 and later when Contextual Menus 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  CopyMenuItemData

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  CopyMenuItems

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  CopyMenuItemTextAsCFString

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  CopyMenuTitleAsCFString

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  CountMenuItems

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  CountMenuItemsWithCommandID

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Unsupported  CountMItems

CountMItems has been renamed to CountMenuItems in Carbon. Not available in CarbonLib. Not available in Mac OS X.

Supported  CreateCustomMenu

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  CreateNewMenu

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  CreateStandardFontMenu

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Not Recommended  DeleteMCEntries

DeleteMCEntries does nothing, because the Appearance Manager doesn't use color tables. Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  DeleteMenu

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  DeleteMenuItem

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  DeleteMenuItems

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  DisableAllMenuItems

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Unsupported  DisableItem

Replaced by DisableMenuItem. Not available in CarbonLib. Not available in Mac OS X.

Supported  DisableMenuCommand

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  DisableMenuItem

Note that the implementation of Carbon on Mac OS 8.1 only supports disabling menu items less than or equal to 31. Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Supported  DisableMenuItemIcon

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Unsupported  DisposeMBarHookUPP

Accessing the MBarHook low-memory global variable is not supported in Carbon. Use the Carbon Event Manager to work with menu bar events instead.

Not Recommended  DisposeMCInfo

DisposeMCInfo does nothing, because Appearance Manager doesn't use color tables. Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  DisposeMenu

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  DisposeMenuBar

Available in CarbonLib 1.0.2 and later. Available in Mac OS X 10.0 and later.

Unsupported  DisposeMenuBarDefUPP

The menu bar is not customizable in Carbon.

Not Recommended  DisposeMenuDefUPP

Apple discourages you from writing and using your own menu definition functions and encourages you to use the system-supplied menu definition function instead. New features that have previously been missing are now available in the system-supplied menu definition function. Since Appearance Manager 1.0 (in Mac OS 8.0), for example, the system-supplied menu definition function has supported extended menu item command key modifiers and glyphs. And in Carbon, the system-supplied menu definition function supports dynamic items, which allow the contents of a menu item to be redrawn while the menu is displayed in response to the user pressing a modifier key on the keyboard. Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Unsupported  DisposeMenuHookUPP

Accessing the MenuHook low-memory global variable is not supported in Carbon. Use the Carbon Event Manager to work with menu events instead.

Supported  DrawMenuBar

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  DuplicateMenu

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  DuplicateMenuBar

Available in CarbonLib 1.0.2 and later. Available in Mac OS X 10.0 and later.

Supported  EnableAllMenuItems

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Unsupported  EnableItem

Replaced by EnableMenuItem. Not available in CarbonLib. Not available in Mac OS X.

Supported  EnableMenuCommand

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  EnableMenuItem

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Supported  EnableMenuItemIcon

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Supported  EraseMenuBackground

Available in CarbonLib 1.5 and later. Available in Mac OS X 10.1 and later.

Supported  FlashMenuBar

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  GetFontFamilyFromMenuSelection

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  GetIndMenuItemWithCommandID

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  GetItemCmd

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  GetItemIcon

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  GetItemMark

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  GetItemStyle

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  GetMBarHeight

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Not Recommended  GetMCEntry

GetMCEntry does nothing, because Appearance Manager doesn't use color tables. Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Not Recommended  GetMCInfo

GetMCInfo does nothing, because Appearance Manager doesn't use color tables. Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Modified  GetMenu

In Carbon, the GetMenu function always returns a newly created MenuRef. Prior to Carbon, GetMenu would first check if the menu was already in memory. If so, GetMenu would return the in-memory copy. This behavior is no longer supported.

Carbon does not support custom menu definitions stored in 'MDEF' resources. If you want to specify a custom menu definition for GetMenu, you must compile your definition function directly in your application and then register the function by calling RegisterMenuDefinition. When GetMenu gets a resourceID value that doesn't recognize, it checks a special mapping table to find the pointer that's registered for the resourceID parameter. It then calls that function to implement your menu. Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  GetMenuAttributes

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  GetMenuBar

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  GetMenuCommandMark

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  GetMenuCommandProperty

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  GetMenuCommandPropertySize

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  GetMenuDefinition

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Not Recommended  GetMenuExcludesMarkColumn

You should instead inspect the kMenuExcludesMarkColumn menu attribute using the GetMenuAttributes function. Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Supported  GetMenuFont

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Supported  GetMenuHandle

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  GetMenuHeight

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  GetMenuID

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  GetMenuItemAttributes

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  GetMenuItemCommandID

Available in CarbonLib 1.0 and later when Appearance 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  GetMenuItemCommandKey

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  GetMenuItemFontID

Available in CarbonLib 1.0 and later when Appearance 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  GetMenuItemHierarchicalID

Available in CarbonLib 1.0 and later when Appearance 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  GetMenuItemHierarchicalMenu

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  GetMenuItemIconHandle

Available in CarbonLib 1.0 and later when Appearance 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  GetMenuItemIndent

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  GetMenuItemKeyGlyph

Available in CarbonLib 1.0 and later when Appearance 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  GetMenuItemModifiers

Available in CarbonLib 1.0 and later when Appearance 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  GetMenuItemProperty

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Supported  GetMenuItemPropertyAttributes

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  GetMenuItemPropertySize

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Supported  GetMenuItemRefCon

Available in CarbonLib 1.0 and later when Appearance 1.0 or later is present. Available in Mac OS X 10.0 and later.

Unsupported  GetMenuItemRefCon2

To associate data with a menu item you should instead use the Get/SetMenuItemProperty functions available with the Mac OS 8.5 Menu Manager. Not available in CarbonLib. Not available in Mac OS X.

Supported  GetMenuItemText

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Unsupported  getmenuitemtext

Use GetMenuItemText instead. Not available in CarbonLib. Not available in Mac OS X.

Supported  GetMenuItemTextEncoding

Available in CarbonLib 1.0 and later when Appearance 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  GetMenuRetainCount

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  GetMenuTitle

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  GetMenuTitleIcon

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  GetMenuTrackingData

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  GetMenuType

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  GetMenuWidth

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  GetNewMBar

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  HideMenuBar

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Supported  HiliteMenu

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  InitContextualMenus

Available in CarbonLib 1.0 and later when Contextual Menus 1.0 or later is present. Available in Mac OS X 10.0 and later.

Unsupported  InitMenus

InitMenus is not supported in Carbon. There is no need to initialize the Menu Manager because the shared library is loaded as needed. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  InitProcMenu

You must use the standard menu bar definition function (MBDF). Not available in CarbonLib. Not available in Mac OS X.

Supported  InsertFontResMenu

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  InsertIntlResMenu

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  InsertMenu

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  InsertMenuItem

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Unsupported  insertmenuitem

Use InsertMenuItem instead. Not available in CarbonLib. Not available in Mac OS X.

Supported  InsertMenuItemText

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Supported  InsertMenuItemTextWithCFString

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  InsertResMenu

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  InvalidateMenuEnabling

Available in CarbonLib 1.3 and later. Available in Mac OS X 10.0 and later.

Supported  InvalidateMenuItems

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  InvalidateMenuSize

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  InvalMenuBar

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Unsupported  InvokeMBarHookUPP

Accessing the MBarHook low-memory global variable is not supported in Carbon. Use the Carbon Event Manager to work with menu bar events instead.

Unsupported  InvokeMenuBarDefUPP

The menu bar is not customizable in Carbon.

Not Recommended  InvokeMenuDefUPP

Apple discourages you from writing and using your own menu definition functions and encourages you to use the system-supplied menu definition function instead. New features that have previously been missing are now available in the system-supplied menu definition function. Since Appearance Manager 1.0 (in Mac OS 8.0), for example, the system-supplied menu definition function has supported extended menu item command key modifiers and glyphs. And in Carbon, the system-supplied menu definition function supports dynamic items, which allow the contents of a menu item to be redrawn while the menu is displayed in response to the user pressing a modifier key on the keyboard. Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Unsupported  InvokeMenuHookUPP

Accessing the MenuHook low-memory global variable is not supported in Carbon. Use the Carbon Event Manager to work with menu events instead.

Supported  IsMenuBarInvalid

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  IsMenuBarVisible

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Supported  IsMenuCommandEnabled

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  IsMenuItemEnabled

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Supported  IsMenuItemIconEnabled

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Supported  IsMenuItemInvalid

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  IsMenuKeyEvent

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  IsMenuSizeInvalid

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  IsShowContextualMenuClick

Available in CarbonLib 1.0 and later when Contextual Menus 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  IsShowContextualMenuEvent

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  IsValidMenu

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  LMGetTheMenu

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  MenuChoice

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  MenuEvent

Available in CarbonLib 1.0 and later when Appearance 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  MenuHasEnabledItems

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  MenuKey

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  MenuSelect

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Unsupported  menuselect

Use MenuSelect instead. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  NewMBarHookUPP

Accessing the MBarHook low-memory global variable is not supported in Carbon. Use the Carbon Event Manager to work with menu bar events instead.

Supported  NewMenu

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Unsupported  newmenu

Use NewMenu instead. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  NewMenuBarDefUPP

The menu bar is not customizable in Carbon.

Not Recommended  NewMenuDefUPP

Apple discourages you from writing and using your own menu definition functions and encourages you to use the system-supplied menu definition function instead. New features that have previously been missing are now available in the system-supplied menu definition function. Since Appearance Manager 1.0 (in Mac OS 8.0), for example, the system-supplied menu definition function has supported extended menu item command key modifiers and glyphs. And in Carbon, the system-supplied menu definition function supports dynamic items, which allow the contents of a menu item to be redrawn while the menu is displayed in response to the user pressing a modifier key on the keyboard. Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Unsupported  NewMenuHookUPP

Accessing the MenuHook low-memory global variable is not supported in Carbon. Use the Carbon Event Manager to work with menu events instead.

Supported  PopUpMenuSelect

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  ProcessIsContextualMenuClient

Available in CarbonLib 1.0 and later when Contextual Menus 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  RegisterMenuDefinition

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  ReleaseMenu

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  RemoveMenuCommandProperty

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  RemoveMenuItemProperty

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Supported  RetainMenu

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  ScrollMenuImage

Available in CarbonLib 1.5 and later. Available in Mac OS X 10.1 and later.

Supported  SetItemCmd

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  SetItemIcon

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  SetItemMark

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  SetItemStyle

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Not Recommended  SetMCEntries

SetMCEntries does nothing, because Appearance Manager doesn't use color tables. Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Not Recommended  SetMCInfo

SetMCInfo does nothing, because Appearance Manager doesn't use color tables. Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  SetMenuBar

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  SetMenuCommandMark

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  SetMenuCommandProperty

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  SetMenuDefinition

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Not Recommended  SetMenuExcludesMarkColumn

You should instead set the kMenuExcludesMarkColumn menu attribute using the SetMenuAttributes function. Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Unsupported  SetMenuFlash

In the future, the Appearance Manager may control menu-flashing behavior. Not available in CarbonLib. Not available in Mac OS X.

Supported  SetMenuFlashCount

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  SetMenuFont

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Supported  SetMenuHeight

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  SetMenuID

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  SetMenuItemCommandID

Available in CarbonLib 1.0 and later when Appearance 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  SetMenuItemCommandKey

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  SetMenuItemData

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  SetMenuItemFontID

Available in CarbonLib 1.0 and later when Appearance 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  SetMenuItemHierarchicalID

Available in CarbonLib 1.0 and later when Appearance 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  SetMenuItemHierarchicalMenu

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Unsupported  SetMenuItemHotKey

Supported  SetMenuItemIconHandle

Available in CarbonLib 1.0 and later when Appearance 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  SetMenuItemIndent

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  SetMenuItemKeyGlyph

Available in CarbonLib 1.0 and later when Appearance 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  SetMenuItemModifiers

Available in CarbonLib 1.0 and later when Appearance 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  SetMenuItemProperty

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Supported  SetMenuItemRefCon

Available in CarbonLib 1.0 and later when Appearance 1.0 or later is present. Available in Mac OS X 10.0 and later.

Unsupported  SetMenuItemRefCon2

To associate data with a menu item in Carbon, you should instead use the Get/SetMenuItemProperty functions. Not available in CarbonLib. Not available in Mac OS X.

Supported  SetMenuItemText

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Unsupported  setmenuitemtext

Use SetMenuItemText instead. Not available in CarbonLib. Not available in Mac OS X.

Supported  SetMenuItemTextEncoding

Available in CarbonLib 1.0 and later when Appearance 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  SetMenuItemTextWithCFString

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  SetMenuTitle

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  SetMenuTitleIcon

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  SetMenuTitleWithCFString

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  SetMenuWidth

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  SetRootMenu

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  ShowMenuBar

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Unsupported  SystemEdit

Carbon does not support desk accessories. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  SystemMenu

Carbon does not support desk accessories. Not available in CarbonLib. Not available in Mac OS X.

Supported  UpdateInvalidMenuItems

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  UpdateStandardFontMenu

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

[Table of Contents] [Manager Index] [Function Index]

Generated on: 12/12/2001. Copyright © 1999-2001 Apple Computer, Inc. All rights reserved.