KIO
KFileItemActions Class Reference
This class creates and handles the actions for a url (or urls) in a popupmenu. More...
#include <kfileitemactions.h>

Public Member Functions | |
void | addOpenWithActionsTo (QMenu *menu, const QString &traderConstraint) |
int | addServiceActionsTo (QMenu *menu) |
KFileItemActions (QObject *parent=0) | |
KAction * | preferredOpenWithAction (const QString &traderConstraint) |
void | setItemListProperties (const KFileItemListProperties &itemList) |
void | setParentWidget (QWidget *widget) |
~KFileItemActions () |
Detailed Description
This class creates and handles the actions for a url (or urls) in a popupmenu.
This includes:
- "open with <application>" actions, but also
- builtin services like mount/unmount for old-style device desktop files
- user-defined actions for a .desktop file, defined in the file itself (see the desktop entry standard)
- servicemenus actions, defined in .desktop files and selected based on the mimetype of the url
- Since:
- 4.3
Definition at line 43 of file kfileitemactions.h.
Constructor & Destructor Documentation
KFileItemActions::KFileItemActions | ( | QObject * | parent = 0 |
) |
Creates a KFileItemActions instance.
Note that this instance must stay alive for at least as long as the popupmenu; it has the slots for the actions created by addOpenWithActionsTo/addServiceActionsTo.
Definition at line 176 of file kfileitemactions.cpp.
KFileItemActions::~KFileItemActions | ( | ) |
Destructor.
Definition at line 182 of file kfileitemactions.cpp.
Member Function Documentation
Generate the "Open With <Application>" actions, and adds them to the menu
.
All actions are created as children of the menu.
- Parameters:
-
menu the QMenu where to add actions traderConstraint this constraint allows to exclude the current application from the "open with" list. Example: "DesktopEntryName != 'kfmclient'".
Definition at line 490 of file kfileitemactions.cpp.
int KFileItemActions::addServiceActionsTo | ( | QMenu * | menu | ) |
Generate the user-defined actions and submenus, and adds them to the menu
.
User-defined actions include:
- builtin services like mount/unmount for old-style device desktop files
- user-defined actions for a .desktop file, defined in the file itself (see the desktop entry standard)
- servicemenus actions, defined in .desktop files and selected based on the mimetype of the url
When KFileItemListProperties::supportsWriting() is false, actions that modify the files are not shown. This is controlled by Require=Write in the servicemenu desktop files.
All actions are created as children of the menu.
- Returns:
- the number of actions added
Definition at line 192 of file kfileitemactions.cpp.
Returns an action for the preferred application only.
- Parameters:
-
traderConstraint this constraint allows to exclude the current application from the "open with" list. Example: "DesktopEntryName != 'kfmclient'".
- Returns:
- the action - or 0 if no application was found.
Definition at line 581 of file kfileitemactions.cpp.
void KFileItemActions::setItemListProperties | ( | const KFileItemListProperties & | itemList | ) |
Sets all the data for the next instance of the popupmenu.
- See also:
- KFileItemListProperties
Definition at line 187 of file kfileitemactions.cpp.
void KFileItemActions::setParentWidget | ( | QWidget * | widget | ) |
Set the parent widget for any dialogs being shown.
This should normally be your mainwindow, not a popup menu, so that it still exists even after the popup is closed (e.g. error message from KRun) and so that QAction::setStatusTip can find a statusbar, too.
Definition at line 590 of file kfileitemactions.cpp.
The documentation for this class was generated from the following files: