/usr/include/konq_menuactions.h is in libkonq5-dev 4:16.08.3-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 | /* This file is part of the KDE project
Copyright (C) 1998-2009 David Faure <faure@kde.org>
This library is free software; you can redistribute it and/or modify
it under the terms of the GNU Library General Public License as published
by the Free Software Foundation; either version 2 of the License or
( at your option ) version 3 or, at the discretion of KDE e.V.
( which shall act as a proxy as in section 14 of the GPLv3 ), any later version.
This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Library General Public License for more details.
You should have received a copy of the GNU Library General Public License
along with this library; see the file COPYING.LIB. If not, write to
the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
Boston, MA 02110-1301, USA.
*/
#ifndef KONQ_MENUACTIONS_H
#define KONQ_MENUACTIONS_H
#include <kfileitem.h>
#include <libkonq_export.h>
class KFileItemActions;
class KFileItemListProperties;
class KAction;
class KonqPopupMenuInformation;
class QMenu;
/**
* This class handles the user-defined actions for a url in a popupmenu.
* 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
*
* In addition it can also add "open with" actions.
*/
class LIBKONQ_EXPORT KonqMenuActions
{
public:
/**
* Creates a KonqMenuActions 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 addActionsTo.
*/
KonqMenuActions();
/**
* Destructor
*/
~KonqMenuActions();
/**
* Sets all the data for the next instance of the popupmenu.
* @see KonqPopupMenuInformation
* @deprecated use setItemList+setParentWidget
*/
KDE_DEPRECATED void setPopupMenuInfo(const KonqPopupMenuInformation& info);
/**
* Sets all the data for the next instance of the popupmenu.
* @see KFileItemListProperties
* @since 4.3
*/
void setItemListProperties(const KFileItemListProperties& itemList);
/**
* 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.
* @since 4.3
*/
void setParentWidget(QWidget* widget);
/**
* Generate the user-defined actions and submenus, and adds them to the @p 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.
* @return the number of actions added
*/
int addActionsTo(QMenu* menu); // NOTE: renamed to addServiceActionsTo() in KFileItemActions
/**
* Generate the "Open With <Application>" actions, and adds them to the @p menu.
* All actions are created as children of the menu.
* @param menu the QMenu where to add actions
* @param traderConstraint this constraint allows to exclude the current application
* from the "open with" list. Example: "DesktopEntryName != 'kfmclient'".
*/
void addOpenWithActionsTo(QMenu* menu, const QString& traderConstraint);
/**
* Returns an action for the preferred app only.
* @param traderConstraint this constraint allows to exclude the current application
* from the "open with" list. Example: "DesktopEntryName != 'kfmclient'".
* @return the action - or 0 if no application was found.
* @since 4.3 -- TODO REMOVE AND PORT FOLDERVIEW
*/
KAction* preferredOpenWithAction(const QString& traderConstraint);
private:
KFileItemActions* const d;
};
#endif /* KONQ_MENUACTIONS_H */
|