KDE 4.3 PyKDE API Reference
KToolBarPopupAction Class Reference
from PyKDE4.kdeui import *
Inherits: KAction → QWidgetAction → QAction → QObject
Detailed Description
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 | |
| __init__ (self, KIcon icon, QString text, QObject parent) | |
| QWidget | createWidget (self, QWidget parent) |
| bool | delayed (self) |
| KMenu | popupMenu (self) |
| setDelayed (self, bool delayed) | |
| setStickyMenu (self, bool sticky) | |
| bool | stickyMenu (self) |
Method Documentation
Create a KToolBarPopupAction, with a text, an icon, a parent and a name.
- Parameters:
-
icon The icon to display. text The text that will be displayed. parent This action's parent.
| bool delayed | ( | self ) |
Returns true if this action creates a delayed popup menu when plugged in a KToolBar.
| KMenu popupMenu | ( | self ) |
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 | ( | self, | ||
| bool | delayed | |||
| ) |
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 | ( | self, | ||
| bool | sticky | |||
| ) |
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.
| bool stickyMenu | ( | self ) |
Returns true if this action creates a sticky popup menu.
- See also:
- setStickyMenu().
