KDE 4.3 PyKDE API Reference
  • KDE's Python API
  • Overview
  • PyKDE Home
  • Sitemap
  • Contact Us
 

KActionMenu Class Reference

from PyKDE4.kdeui import *

Inherits: KAction → QWidgetAction → QAction → QObject

Detailed Description

A KActionMenu is an action that has several properties specific to holding a sub-menu of other actions.

Any QAction can be used to create a submenu.

Plugged in a popupmenu, it will create a submenu. Plugged in a toolbar, it will create a button with a popup menu.

This is the action used by the XMLGUI since it holds other actions. If you want a submenu for selecting one tool among many (without icons), see KSelectAction. See also setDelayed about the main action.


Methods

 __init__ (self, QObject parent)
 __init__ (self, QString text, QObject parent)
 __init__ (self, KIcon icon, QString text, QObject parent)
 addAction (self, QAction action)
QAction addSeparator (self)
QWidget createWidget (self, QWidget parent)
bool delayed (self)
 insertAction (self, QAction before, QAction action)
QAction insertSeparator (self, QAction before)
KMenu menu (self)
KMenu popupMenu (self)
 remove (self, KAction a0)
 removeAction (self, QAction action)
 setDelayed (self, bool delayed)
 setMenu (self, KMenu menu)
 setStickyMenu (self, bool sticky)
bool stickyMenu (self)

Method Documentation

__init__ (  self,
QObject  parent
)
__init__ (  self,
QString  text,
QObject  parent
)
__init__ (  self,
KIcon  icon,
QString  text,
QObject  parent
)
addAction (  self,
QAction  action
)
QAction addSeparator (   self )
QWidget createWidget (  self,
QWidget  parent
)
bool delayed (   self )

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

insertAction (  self,
QAction  before,
QAction  action
)
QAction insertSeparator (  self,
QAction  before
)
KMenu menu (   self )

Returns this action's menu as a KMenu, if it is one. If none exists, one will be created.

KMenu popupMenu (   self )

Returns this action's menu as a KMenu, if it is one. If none exists, one will be created.

Deprecated:
use menu() instead.

remove (  self,
KAction  a0
)

Deprecated:

removeAction (  self,
QAction  action
)
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

Remember that if the "main" action (the toolbar button itself) cannot be clicked, then you should call setDelayed(false).

In the other case, if the main action can be clicked, it can only happen in a toolbar: in a menu, the parent of a submenu can't be activated. To get a "normal" menu item when plugged a menu (and no submenu) use KToolBarPopupAction.

setMenu (  self,
KMenu  menu
)
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. Default: sticky.

bool stickyMenu (   self )

Returns true if this action creates a sticky popup menu.

See also:
setStickyMenu().

  • Full Index

Modules

  • akonadi
  • dnssd
  • kdecore
  • kdeui
  • khtml
  • kio
  • knewstuff
  • kparts
  • kutils
  • nepomuk
  • phonon
  • plasma
  • polkitqt
  • solid
  • soprano
This documentation is maintained by Simon Edwards.
KDE® and the K Desktop Environment® logo are registered trademarks of KDE e.V. | Legal