# class KToolBarPopupAction

###

Module | kdeui
Namespace |
Class | KToolBarPopupAction
Inherits | KAction

This action is a normal action everywhere, except in a toolbar where it also has a popupmenu (optionally delayed). This action is designed for history actions (back/forward, undo/redo) and for any other action that has more detail in a toolbar than in a menu (e.g. tool chooser with "Other" leading to a dialog...).

In contrast to KActionMenu, this action is a simple menuitem when plugged into a menu, and has a popup only in a toolbar.

Use cases include Back/Forward, and Undo/Redo. Simple click is what's most commonly used, and enough for menus, but in toolbars there is also an optional popup to go back N steps or undo N steps.

### methods

- KToolBarPopupAction (icon, text, parent)

  returns ctor

  Argument | Type | Default
  --- | --- | ---
  icon | KIcon |
  text | QString |
  parent | QObject |

  Create a KToolBarPopupAction, with a text, an icon, a parent and a name.

  icon - The icon to display.

  text - The text that will be displayed.

  parent - This action's parent.

- createWidget (parent)

  returns QWidget

  Argument | Type | Default
  --- | --- | ---
  parent | QWidget |

  Reimplemented from

  See also QActionWidgetFactory.

- delayed ( )

  returns bool

  Returns true if this action creates a delayed popup menu when plugged in a KToolBar.

- popupMenu ( )

  returns KMenu

  The popup menu that is shown when clicking (some time) on the toolbar button. You may want to plug items into it on creation, or connect to aboutToShow for a more dynamic menu.

  Deprecated use menu() instead

- setDelayed (delayed)

  returns Nothing

  Argument | Type | Default
  --- | --- | ---
  delayed | bool |

  If set to true, this action will create a delayed popup menu when plugged in a KToolBar. Otherwise it creates a normal popup. Default: delayed.

- setStickyMenu (sticky)

  returns Nothing

  Argument | Type | Default
  --- | --- | ---
  sticky | bool |

  If set to true, this action will create a sticky popup menu when plugged in a KToolBar. "Sticky", means it's visible until a selection is made or the mouse is clicked elsewhere. This feature allows you to make a selection without having to press and hold down the mouse while making a selection. Only available if delayed() is true. Default: sticky.

- stickyMenu ( )

  returns bool

  Returns true if this action creates a sticky popup menu.

  See also setStickyMenu().