Menu

The Menu is a class that represents Cocoa’s NSMenu.

class Menu(name)

Parameters:name – String. See name

Creates a menu with the specified name.

name

The name of the menu.

add(menu_or_item[, index=None])

Parameters:

• menu_or_item – Menu or MenuItem.
• index – Integer.

Adds the instance specified by menu_or_item to its subitems. If index is not None, the item will be inserted at the specified index. Otherwise, it will be added at the end of the list.

addItem(name[, action=None, shortcut=None, tag=None, index=None])

Parameters:

• name – String. See MenuItem.name.
• action – Action. See MenuItem.action.
• shortcut – String. See MenuItem.shortcut.
• tag – Integer or Literal Constants. See MenuItem.tag.
• index – Integer. See add().

Creates a MenuItem and adds it to the menu’s items. The method arguments are passed to the menu item constructor.

addSeparator([index=None])

Parameters:index – Integer. See add().

Add a separator item to the menu.

addMenu(name[, index=None])

Parameters:

• name – String. See name.
• index – Integer. See add().

Create a new submenu and add it to our menu’s items.

removeItem(index)

Parameters:index – Integer.

Remove item at index.

MenuItem

The MenuItem is a class that represents Cocoa’s NSMenuItem.

class MenuItem(name, action=None, shortcut=None, tag=None)

Parameters:

• name – String. See MenuItem.name.
• action – Action. See MenuItem.action.
• shortcut – String. See MenuItem.shortcut.
• tag – Integer or Literal Constants. See MenuItem.tag.

name

The name of the menu.

action

Action. The action that is performed on click. Equivalent to [self setTarget:] and [self setAction:].

shortcut

A string that represent the keyboard shortcut that triggers the item. This string has the format “modifiers+letter”, for example, “cmd+f”. Available modifiers are “cmd”, “ctrl”, “alt” and “shift”.

Some special characters are supported through special identifiers. The list of supported identifiers is there. For example, if you want a shortcut that is activated on cmd+<up arrow>, your shorcut would be cmd+arrowup.

tag

Integer value corresponding to [self tag].

state

Cocoa constant. Use with NSCellStateValue constants.

MainMenu

This special class builds the same main menu that is created when you create a new XIB project.

class MainMenu(appname)

Parameters:appname – String

The appname param is used to create menu items like “Quit <appname>” and “About <appname>”.