diff --git a/src/services/kserviceaction.h b/src/services/kserviceaction.h index f8b6f5e..a76e9bc 100644 --- a/src/services/kserviceaction.h +++ b/src/services/kserviceaction.h @@ -1,147 +1,147 @@ /* This file is part of the KDE project Copyright 2007 David Faure 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) 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 KSERVICEACTION_H #define KSERVICEACTION_H #include #include class QVariant; class KServiceActionPrivate; class KService; // we can't include kservice.h, it includes this header... typedef QExplicitlySharedDataPointer KServicePtr; /** * @class KServiceAction kserviceaction.h * * Represents an action in a .desktop file * Actions are defined with the config key Actions in the [Desktop Entry] * group, followed by one group per action, as per the desktop entry standard. * @see KService::actions */ class KSERVICE_EXPORT KServiceAction { public: #if KSERVICE_ENABLE_DEPRECATED_SINCE(5, 69) /** * Creates a KServiceAction. * Normally you don't have to do this, KService creates the actions * when parsing the .desktop file. * @deprecated Since 5.69, use the 6-args constructor */ - KSERVICE_DEPRECATED_VERSION(5, 71, "Use the 6-args constructor") // tag only added for 5.71, so has to be != API dox :/ + KSERVICE_DEPRECATED_VERSION_BELATED(5, 71, 5, 69, "Use the 6-args constructor") KServiceAction(const QString &name, const QString &text, const QString &icon, const QString &exec, bool noDisplay = false); #endif /** * Creates a KServiceAction. * Normally you don't have to do this, KService creates the actions * when parsing the .desktop file. * @since 5.69 */ KServiceAction(const QString &name, const QString &text, const QString &icon, const QString &exec, bool noDisplay, const KServicePtr &service); /** * @internal * Needed for operator>> */ KServiceAction(); /** * Destroys a KServiceAction. */ ~KServiceAction(); /** * Copy constructor */ KServiceAction(const KServiceAction &other); /** * Assignment operator */ KServiceAction &operator=(const KServiceAction &other); /** * Sets the action's internal data to the given @p userData. */ void setData(const QVariant &userData); /** * @return the action's internal data. */ QVariant data() const; /** * @return the action's internal name * For instance Actions=Setup;... and the group [Desktop Action Setup] * define an action with the name "Setup". */ QString name() const; /** * @return the action's text, as defined by the Name key in the desktop action group */ QString text() const; /** * @return the action's icon, as defined by the Icon key in the desktop action group */ QString icon() const; /** * @return the action's exec command, as defined by the Exec key in the desktop action group */ QString exec() const; /** * Returns whether the action should be suppressed in menus. * This is useful for having actions with a known name that the code * looks for explicitly, like Setup and Root for kscreensaver actions, * and which should not appear in popup menus. * @return true to suppress this service */ bool noDisplay() const; /** * Returns whether the action is a separator. * This is true when the Actions key contains "_SEPARATOR_". */ bool isSeparator() const; /** * Returns the service that this action comes from * @since 5.69 */ KServicePtr service() const; private: QSharedDataPointer d; friend KSERVICE_EXPORT QDataStream &operator>>(QDataStream &str, KServiceAction &act); friend KSERVICE_EXPORT QDataStream &operator<<(QDataStream &str, const KServiceAction &act); friend class KService; void setService(const KServicePtr &service); }; KSERVICE_EXPORT QDataStream &operator>>(QDataStream &str, KServiceAction &act); KSERVICE_EXPORT QDataStream &operator<<(QDataStream &str, const KServiceAction &act); #endif /* KSERVICEACTION_H */