Class ToolBar

Returns: a new object with type S, a subtype of T

Overrides: object.__new__

Add a new command to this menu/toolbar. Note that when invoked, the command is automatically enclosed in an undo group, so that undo/redo functionality works. Optional arguments can be specified by name. Note that if the command argument is not specified, then the command will be auto-created as a "nuke.createNode()" using the name argument as the node to create.

Example: menubar = nuke.menu('Nuke') fileMenu = menubar.findItem('File') fileMenu.addCommand('NewCommand', 'print 10', shortcut='t')

Parameters:

• name - The name for the menu/toolbar item. The name may contain submenu names delimited by '/' or '', and submenus are created as needed.
• command - Optional. The command to add to the menu/toolbar. This can be a string to evaluate or a Python Callable (function, method, etc) to run.
• shortcut - Optional. The keyboard shortcut for the command, such as 'R', 'F5' or 'Ctrl-H'. Note that this overrides pre-existing other uses for the shortcut.
• icon - Optional. An icon for the command. This should be a path to an icon in the nuke.pluginPath() directory. If the icon is not specified, Nuke will automatically try to find an icon with the name argument and .png appended to it.
• tooltip - Optional. The tooltip text, displayed on mouseover for toolbar buttons.
• index - Optional. The position to insert the new item in, in the menu/toolbar. This defaults to last in the menu/toolbar.
• readonly - Optional. True/False for whether the item should be available when the menu is invoked in a read-only context.
• contextWidget - Optional. Sets the shortcut context widget (0==Window, 1=Application, 2=DAG).

Returns: The menu/toolbar item that was added to hold the command

The menu/toolbar item that was added to hold the command.

Add a new submenu.

Parameters:

• **kwargs, The, following, keyword, arguments, are, accepted - name The name for the menu/toolbar item icon An icon for the menu. Loaded from the nuke search path. tooltip The tooltip text. index The position to insert the menu in. Use -1 to add to the end of the menu.

Returns: The submenu that was added

The submenu that was added.

Add a separator to this menu/toolbar.

Parameters:

• **kwargs, The, following, keyword, arguments, are, accepted - index The position to insert the new separator in, in the menu/toolbar.

Returns: The separator that was created

The separator that was created.

Clears a menu.

Parameters:

• **kwargs, The, following, keyword, arguments, are, accepted - name The name for the menu/toolbar item

Returns:

true if cleared, false if menu not found

Finds a submenu or command with a particular name.

Parameters:

• name - The name to search for.

Returns: Menu or None

The submenu or command we found, or None if we could not find anything.

Finds a submenu or command with a particular name.

Parameters:

• name - The name to search for.

Returns: Menu or None

The submenu or command we found, or None if we could not find anything.

Removes a submenu or command with a particular name. If the containing menu becomes empty, it will be removed too.

Parameters:

• name - The name to remove for.

Returns: None

true if removed, false if menu not found

Updates menu items' states. Call on about to show menu.

Returns: None