ContextMenuWidgetExtension

class omni.kit.widget.context_menu.context_menu.ContextMenuWidgetExtension

Bases: IExt

Context menu core functionality

Methods

__init__()

ContextMenuWidgetExtension init function.

close_menu()

Close currently open context menu.

get_context_menu()

Gets current context_menu.

menu(name[, delegate, glyph, submenu, tearable])

Creates a menu.

menu_item(name[, triggered_fn, enabled, ...])

Creates a menu item.

on_shutdown()

ContextMenuWidgetExtension shutdown function.

on_startup(ext_id)

ContextMenuWidgetExtension startup function.

separator([name])

Creates a menu separator.

show_context_menu(menu_name, objects, menu_list)

build context menu from menu_list

Attributes

name

Name of current context menu.

__init__()

ContextMenuWidgetExtension init function.

close_menu()

Close currently open context menu. Used by tests not to leave context menu in bad state.

get_context_menu()

Gets current context_menu.

Returns

Current context_menu.

Return type

(str)

menu(name: str, delegate=None, glyph='', submenu=False, tearable=False, **kwargs)

Creates a menu.

Parameters
  • name (str) – Name of the menu.

  • delegate (ui.MenuDelegate) – Specify the delegate to create a custom menu. Optional.

  • glyph (str) – Path of the glyph image to show before the menu name. Optional.

  • submenu (bool) – Enables the submenu marker. Optional.

  • tearable (bool) – The ability to tear the window off. Optional.

Returns

Menu item created.

Return type

(uiMenu)

menu_item(name: str, triggered_fn: Optional[Callable] = None, enabled: bool = True, checkable: bool = False, checked: bool = False, is_async_func=False, delegate=None, additional_kwargs=None, glyph='')

Creates a menu item.

Parameters
  • name (str) – Name of the menu item.

  • triggered_fn (Callable) – Function to call when menu item is clicked. Optional.

  • enabled (bool) – Enable the menu item. Optional.

  • checkable (bool) – This property holds whether this menu item is checkable. A checkable item is one which has an on/off state. Optional.

  • checked (bool) – This property holds a flag that specifies the widget has to use eChecked state of the style. It’s on the Widget level because the button can have sub-widgets that are also should be checked. Optional.

  • is_async_func (bool) – Optional.

  • delegate (ui.MenuDelegate) – Specify the delegate to create a custom menu. Optional.

  • additional_kwargs (dict) – Additonal keyword arguments to pass to ui.MenuItem. Optional.

  • glyph (str) – Path of the glyph image to show before the menu name. Optional.

Returns

Menu item created.

Return type

(uiMenuItem)

on_shutdown()

ContextMenuWidgetExtension shutdown function.

on_startup(ext_id)

ContextMenuWidgetExtension startup function.

Parameters

ext_id (str) – Extension identifier.

separator(name: str = '') bool

Creates a menu separator.

Parameters

name (str) – Name of the menu separator. Optional.

show_context_menu(menu_name: str, objects: dict, menu_list: List[dict], min_menu_entries: int = 1, delegate=None) None

build context menu from menu_list

Parameters
  • menu_name (str) – menu name

  • objects (dict) – context_menu data

  • menu_list (list) – list of dictionaries containing context menu values

  • min_menu_entries (int) – minimal number of menu needed for menu to be visible

property name: str

Name of current context menu.

Returns

Name of current context menu.

Return type

(str)