/* SPDX-FileCopyrightText: 2006-2007 Aaron Seigo <:wqaseigo@kde.org> SPDX-FileCopyrightText: 2007 Riccardo Iaconelli SPDX-FileCopyrightText: 2008 Ménard Alexis SPDX-License-Identifier: LGPL-2.0-or-later */ #ifndef PLASMA_APPLET_H #define PLASMA_APPLET_H #include #include #include #include #include #include #include #include namespace KPackage { class Package; } namespace PlasmaQuick { class AppletQuickItem; class ConfigViewPrivate; class ConfigModelPrivate; class ConfigModel; class ConfigView; }; class DeclarativeAppletScript; #include class KConfigLoader; class KConfigPropertyMap; namespace Plasma { class AppletPrivate; class Containment; class Package; /*! * \class Plasma::Applet * \inheaderfile Plasma/Applet * \inmodule Plasma * * \brief The base Applet class. * * Applet provides several important roles for add-ons widgets in Plasma. * * First, it is the base class for the plugin system and therefore is the * interface to applets for host applications. * Background painting (allowing for consistent and complex * look and feel in just one line of code for applets), loading and starting * of scripting support for each applet, providing access to the associated * plasmoid package (if any) and access to configuration data. * * See techbase.kde.org for tutorials on writing Applets using this class. */ class PLASMA_EXPORT Applet : public QObject { Q_OBJECT /*! * \property Plasma::Applet::id * * Applet id: is unique in the whole Plasma session and will never change across restarts */ Q_PROPERTY(uint id READ id CONSTANT FINAL) /*! * \property Plasma::Applet::title * User friendly title for the plasmoid: it's the localized applet name by default */ Q_PROPERTY(QString title READ title WRITE setTitle NOTIFY titleChanged FINAL) /*! * \property Plasma::Applet::icon * Icon to represent the plasmoid */ Q_PROPERTY(QString icon READ icon WRITE setIcon NOTIFY iconChanged FINAL) // TODO KF6 toolTipMainText toolTipSubText toolTipTextFormat toolTipItem: need to either be here or some other kind of attached property /*! * \property Plasma::Applet::formFactor * The current form factor the applet is being displayed in. */ Q_PROPERTY(Plasma::Types::FormFactor formFactor READ formFactor NOTIFY formFactorChanged) /*! * \property Plasma::Applet::location * The location of the scene which is displaying applet. */ Q_PROPERTY(Plasma::Types::Location location READ location NOTIFY locationChanged) /*! * \property Plasma::Applet::status * Status of the plasmoid: useful to instruct the shell if this plasmoid is requesting attention, if is accepting input, or if is in an idle, inactive state */ Q_PROPERTY(Plasma::Types::ItemStatus status READ status WRITE setStatus NOTIFY statusChanged) /*! * \property Plasma::Applet::immutability * The immutability of the Corona. * Tells the applet whether it should allow for any modification by the user. */ Q_PROPERTY(Plasma::Types::ImmutabilityType immutability READ immutability WRITE setImmutability NOTIFY immutabilityChanged) /*! * \property Plasma::Applet::immutable * Whether the Corona is immutable. The plasmoid implementation should avoid allowing "dangerous" modifications from the user when in an immutable mode * * This is true when immutability is not Mutable */ Q_PROPERTY(bool immutable READ immutable NOTIFY immutabilityChanged) /*! * \property Plasma::Applet::containmentDisplayHints * Display hints that come from the containment that suggest the applet how to look and behave. * TODO: only in containment? */ Q_PROPERTY(Plasma::Types::ContainmentDisplayHints containmentDisplayHints READ containmentDisplayHints NOTIFY containmentDisplayHintsChanged) /*! * \property Plasma::Applet::busy * True if the applet should show a busy status, for instance doing * some network operation */ Q_PROPERTY(bool busy READ isBusy WRITE setBusy NOTIFY busyChanged FINAL) /*! * \property Plasma::Applet::userConfiguring * True when the user is configuring, for instance when the configuration dialog is open. */ Q_PROPERTY(bool userConfiguring READ isUserConfiguring NOTIFY userConfiguringChanged) /*! * \property Plasma::Applet::backgroundHints * How the applet wants its background to be drawn. The containment may chose to ignore this hint. */ Q_PROPERTY(Plasma::Types::BackgroundHints backgroundHints WRITE setBackgroundHints READ backgroundHints NOTIFY backgroundHintsChanged FINAL) /*! * \property Plasma::Applet::userBackgroundHints * The containment (and/or the user) may decide to use another kind of background instead (if supported by the applet) */ Q_PROPERTY(Plasma::Types::BackgroundHints userBackgroundHints WRITE setUserBackgroundHints READ userBackgroundHints NOTIFY userBackgroundHintsChanged FINAL) /*! * \property Plasma::Applet::effectiveBackgroundHints * The effective background hints the applet has, internally decided how to mix with userBackgroundHints */ Q_PROPERTY(Plasma::Types::BackgroundHints effectiveBackgroundHints READ effectiveBackgroundHints NOTIFY effectiveBackgroundHintsChanged FINAL) // TODO KF6: activity, screen, screenGeometry, availableScreenRect, availableScreenRegion: should we instead make the containment accessible from qml // plasmoids and ask from there? /*! * \property Plasma::Applet::configuration * A KConfigPropertyMap instance that represents the configuration * which is usable from QML to read and write settings like any JavaScript Object */ Q_PROPERTY(KConfigPropertyMap *configuration READ configuration CONSTANT FINAL) /*! * \property Plasma::Applet::globalShortcut * The global shortcut to activate the plasmoid * * This is typically only used by the default configuration module * */ Q_PROPERTY(QKeySequence globalShortcut READ globalShortcut WRITE setGlobalShortcut RESET setGlobalShortcut NOTIFY globalShortcutChanged) /*! * \property Plasma::Applet::configurationRequired * If true the applet requires manual configuration from the user */ Q_PROPERTY(bool configurationRequired READ configurationRequired WRITE setConfigurationRequired NOTIFY configurationRequiredChanged) // TODO KF6: having just a reason property and required would be string not empty? Uglier from c++ pov but more straight forward from qml pov /*! * \property Plasma::Applet::hasConfigurationInterface * True if this applet will provide a UI for its configuration */ Q_PROPERTY(bool hasConfigurationInterface READ hasConfigurationInterface WRITE setHasConfigurationInterface NOTIFY hasConfigurationInterfaceChanged) /*! * \property Plasma::Applet::constraintHints * The hints that the applet gives to its constraint, * such as asking to fill all the available space ignoring margins. */ Q_PROPERTY(Plasma::Applet::ConstraintHints constraintHints READ constraintHints WRITE setConstraintHints NOTIFY constraintHintsChanged FINAL) /*! * \property Plasma::Applet::metaData * The metadata of the applet. */ Q_PROPERTY(KPluginMetaData metaData READ pluginMetaData CONSTANT) /*! * \property Plasma::Applet::containment * The Containment managing this applet */ Q_PROPERTY(Plasma::Containment *containment READ containment NOTIFY containmentChanged) /*! * \property Plasma::Applet::contextualActions * Actions to be added in the plasmoid context menu. To instantiate QActions in a declarative way, * PlasmaCore.Action {} can be used */ Q_PROPERTY(QQmlListProperty contextualActions READ qmlContextualActions NOTIFY contextualActionsChanged) /*! * \property Plasma::Applet::isContainment * True if this applet is a Containment and is acting as one, such as a desktop or a panel */ Q_PROPERTY(bool isContainment READ isContainment CONSTANT) /*! * \property Plasma::Applet::pluginName * Plugin name for the applet */ Q_PROPERTY(QString pluginName READ pluginName CONSTANT FINAL) public: /*! * The Constraint enumeration lists the various constraints that Plasma * objects have managed for them and which they may wish to react to, * for instance in Applet::constraintsUpdated * * \value NoConstraint No constraint; never passed in to Applet::constraintsEvent on its own * \value FormFactorConstraint The FormFactor for an object * \value LocationConstraint The Location of an object * \value ScreenConstraint Which screen an object is on * \value ImmutableConstraint The immutability (locked) nature of the applet changed * \value StartupCompletedConstraint Application startup has completed * \value UiReadyConstraint The ui has been completely loaded * \value AllConstraints */ enum Constraint { NoConstraint = 0, FormFactorConstraint = 1, LocationConstraint = 2, ScreenConstraint = 4, ImmutableConstraint = 8, StartupCompletedConstraint = 16, UiReadyConstraint = 32, // (FIXME: merged with StartupCompletedConstraint?) AllConstraints = FormFactorConstraint | LocationConstraint | ScreenConstraint | ImmutableConstraint, }; Q_ENUM(Constraint) Q_DECLARE_FLAGS(Constraints, Constraint) /*! * This enumeration lists the various hints that an applet can pass to its * constraint regarding the way that it is represented * * \value NoHint * \value CanFillArea The CompactRepresentation can fill the area and ignore constraint margins * \value MarginAreasSeparator The applet acts as a separator between the standard and slim panel margin areas */ enum ConstraintHint { NoHint = 0, CanFillArea = 1, // TODO: KF6 CanFillArea -> CompactRepresentationFillArea MarginAreasSeparator = CanFillArea | 2, }; Q_DECLARE_FLAGS(ConstraintHints, ConstraintHint) Q_FLAG(ConstraintHints) // CONSTRUCTORS /*! * This constructor can be used with the KCoreAddons plugin loading system. * The argument list is expected to have contain the KPackage of the applet, * the meta data file path (for compatibility) and an applet ID which must be a base 10 number. * * \a parent a QObject parent; you probably want to pass in 0 * * \a data, KPluginMetaData used to create this plugin * * \a args a list of strings containing the applet id * * \since 5.86 */ Applet(QObject *parentObject, const KPluginMetaData &data, const QVariantList &args); ~Applet() override; // BOOKKEEPING /*! * Returns the id of this applet */ uint id() const; /*! * Returns the arguments this applet was started with. * * Some applets support arguments, for instance the notes applet supports to be * instantiated with a given text already passed as parameter */ QVariantList startupArguments() const; /*! * Returns The type of immutability of this applet */ Types::ImmutabilityType immutability() const; /*! * Returns true if immutability() is not Types::Mutable */ bool immutable() const; /*! * If for some reason, the applet fails to get up on its feet (the * library couldn't be loaded, necessary hardware support wasn't found, * etc..) this method returns the reason why, in an user-readable way. * \since 5.0 **/ QString launchErrorMessage() const; /*! * If for some reason, the applet fails to get up on its feet (the * library couldn't be loaded, necessary hardware support wasn't found, * etc..) this method returns true. **/ bool failedToLaunch() const; /*! * Returns true if destroy() was called; useful for Applets which should avoid * certain tasks if they are about to be deleted permanently */ bool destroyed() const; /*! * Returns the Containment, if any, this applet belongs to. * * A containment will return itself if is a first level * containment such as a desktop or a panel, or will return the * other containment is in if it's a nested containment such a * system tray **/ Containment *containment() const; /*! * Returns \c true if this Applet is currently being used as a Containment, false otherwise. * * Normally only first level Containments directly children of Corona can act * as containments, except Containments of Type CustomEmbedded which can be * containments also when inside another containment, such as a Systray * inside a Panel. */ bool isContainment() const; /*! * Returns the status of the applet * \since 4.4 */ Types::ItemStatus status() const; /*! * Returns the current form factor the applet is being displayed in. */ Types::FormFactor formFactor() const; /*! * Returns the location of the scene which is displaying applet. */ Types::Location location() const; /*! * Returns Display hints that come from the containment that suggest the applet how to look and behave. * \since 5.77 */ Types::ContainmentDisplayHints containmentDisplayHints() const; // CONFIGURATION /*! * Returns the KConfigGroup to access the applets configuration. * * This config object will write to an instance * specific config file named \\rc * in the Plasma appdata directory. **/ KConfigGroup config() const; /*! * Returns a KConfigGroup object to be shared by all applets of this * type. * * This config object will write to an applet-specific config object * named plasma_\rc in the local config directory. */ KConfigGroup globalConfig() const; /*! * Returns the config skeleton object from this applet's package, * if any. * * Returns config skeleton object, or 0 if none **/ KConfigLoader *configScheme() const; /*! * Returns a KConfigPropertyMap instance that represents the configuration * which is usable from QML to read and write settings like any JavaScript Object */ KConfigPropertyMap *configuration(); /*! * Saves state information about this applet that will * be accessed when next instantiated in the restore(KConfigGroup&) method. * * This method does not need to be reimplemented by Applet * subclasses, but can be useful for Applet specializations * (such as Containment) to do so. * * Applet subclasses may instead want to reimplement saveState(). **/ virtual void save(KConfigGroup &group) const; /*! * Restores state information about this applet saved previously * in save(KConfigGroup&). * * This method does not need to be reimplemented by Applet * subclasses, but can be useful for Applet specializations * (such as Containment) to do so. **/ virtual void restore(KConfigGroup &group); /*! * When the applet needs to be configured before being usable, this * method can be called to show a standard interface prompting the user * to configure the applet * * \a needsConfiguring true if the applet needs to be configured, * or false if it doesn't * * \a reason a translated message for the user explaining that the * applet needs configuring; this should note what needs * to be configured */ void setConfigurationRequired(bool needsConfiguring, const QString &reason = QString()); /*! * Returns true if the applet currently needs to be configured, * otherwise, false */ bool configurationRequired() const; /*! * Returns A translated message for the user explaining that the * applet needs configuring; this should note what needs * to be configured * * \sa setConfigurationRequired * \since 5.20 */ QString configurationRequiredReason() const; /*! * Sets the constraint hits which give a more granular control over sizing in * constrained layouts such as panels * * \a constraintHints such as CanFillArea or MarginAreasSeparator, * they can be in bitwise OR */ void setConstraintHints(ConstraintHints constraintHints); /*! * Returns The constraint hints such as CanFillArea or MarginAreasSeparator, * they can be in bitwise OR */ ConstraintHints constraintHints() const; /*! * Returns true when the configuration interface is being shown * \since 4.5 */ bool isUserConfiguring() const; /*! * Tells the applet the user is configuring * * \a configuring true if the configuration ui is showing */ void setUserConfiguring(bool configuring); // UTILS /*! * Called when any of the geometry constraints have been updated. * This method calls constraintsEvent, which may be reimplemented, * once the Applet has been prepared for updating the constraints. * * \a constraints the type of constraints that were updated */ void updateConstraints(Constraints constraints = AllConstraints); // METADATA /*! * Returns metadata information about this plugin * * \since 5.27 */ KPluginMetaData pluginMetaData() const; /*! * Returns the plugin name form KPluginMetaData */ QString pluginName() const; /*! * Returns the user-visible title for the applet, as specified in the * Name field of the .desktop file. Can be changed with setTitle * * \since 5.0 * Returns the user-visible title for the applet. **/ QString title() const; /*! * Sets a custom title for this instance of the applet. E.g. a clock might * use the timezone as its name rather than the .desktop file * * \since 5.0 * \a title the user-visible title for the applet. */ void setTitle(const QString &title); /*! * Returns The icon name related to this applet * By default is the one in the plasmoid desktop file **/ QString icon() const; /*! * Sets an icon name for this applet * \a icon Freedesktop compatible icon name */ void setIcon(const QString &icon); /*! * Returns true if the applet should show a busy status, for instance doing * some network operation * \since 5.21 */ bool isBusy() const; /*! * Sets the Applet to have a busy status hint, for instance the applet doing * some network operation. * The graphical representation of the busy status depends completely from * the visualization. * * \a busy true if the applet is busy * * \since 5.21 */ void setBusy(bool busy); /*! * How the applet wants its background to be drawn. The containment may chose to ignore this hint. * \since 5.65 */ Plasma::Types::BackgroundHints backgroundHints() const; /*! * Sets the applet background hints. Only Applet implementations should write this property * \since 5.65 */ void setBackgroundHints(Plasma::Types::BackgroundHints hint); /*! * The containment (and/or the user) may decide to use another kind of background instead if supported by the applet. * In order for an applet to support user configuration of the * background, it needs to have the Plasma::Types::ConfigurableBackground flag set in its backgroundHints * \since 5.65 */ Plasma::Types::BackgroundHints userBackgroundHints() const; /*! * Sets the hints the user wished the background style for the applet to be. * \since 5.65 */ void setUserBackgroundHints(Plasma::Types::BackgroundHints hint); /*! * The effective background hints the applet will have: it will follow userBackgroundHints only if backgroundHints has the * Plasma::Types::ConfigurableBackground flag set * \since 5.65 */ Plasma::Types::BackgroundHints effectiveBackgroundHints() const; // ACTIONS /*! * Returns a list of context-related QAction instances. * * This is used e.g. within the \a DesktopView to display a * contextmenu. * * Returns A list of actions. The default implementation returns an * empty list. **/ virtual QList contextualActions(); QML_LIST_PROPERTY_ASSIGN_BEHAVIOR_REPLACE QQmlListProperty qmlContextualActions(); /*! * Add a new internal action. if an internal action with the same name already exists, it * will be replaced with this new one. * Those are usually actions defined by the system, such as "configure" and "remove" * * \a name The unique name for the action * * \a action The new QAction to be added */ Q_INVOKABLE void setInternalAction(const QString &name, QAction *action); /*! * Returnss the internal action with the given name if available * * \a name the unique name of the action we want */ Q_INVOKABLE QAction *internalAction(const QString &name) const; /*! * Removes an action from the internal actions * * \a name the action to be removed */ Q_INVOKABLE void removeInternalAction(const QString &name); /*! * Returnss All the internal actions such as configure, remove, alternatives etc */ QList internalActions() const; /*! * Sets the global shortcut to associate with this widget. */ void setGlobalShortcut(const QKeySequence &shortcut = QKeySequence()); /*! * Returns the global shortcut associated with this widget, or * an empty shortcut if no global shortcut is associated. */ QKeySequence globalShortcut() const; /*! * Sets whether or not this applet provides a user interface for * configuring the applet. * * It defaults to false, and if true is passed in you should * also reimplement createConfigurationInterface() * * \a hasInterface whether or not there is a user interface available **/ void setHasConfigurationInterface(bool hasInterface); // Completely UI-specific, remove or move to scriptengine /*! * Returns true if this plasmoid provides a GUI configuration **/ bool hasConfigurationInterface() const; /*! * The translation domain for this applet * * \since 6.1 */ QString translationDomain() const; Q_SIGNALS: // BOOKKEEPING /*! * Emitted when the immutability changes * * \since 4.4 */ void immutabilityChanged(Plasma::Types::ImmutabilityType immutable); /*! * Emitted when the applet status changes * * \since 4.4 */ void statusChanged(Plasma::Types::ItemStatus status); /*! * Emitted when the applet has been scheduled for destruction * or the destruction has been undone * * \since 5.4 */ void destroyedChanged(bool destroyed); /*! * Emitted when the title has changed * * \since 5.20 */ void titleChanged(const QString &title); /*! * Emitted when the icon name for the applet has changed * * \since 5.20 */ void iconChanged(const QString &icon); /*! * Emitted when the busy status has changed * * \since 5.21 */ void busyChanged(bool busy); /*! * Emitted when the background hints have changed * \since 5.65 */ void backgroundHintsChanged(); /*! * Emitted when the user background hints have changed * \since 5.65 */ void userBackgroundHintsChanged(); /*! * Emitted when the effective background hints have changed * \since 5.65 */ void effectiveBackgroundHintsChanged(); /*! * Emitted when the global shortcut to activate this applet has changed */ void globalShortcutChanged(const QKeySequence &sequence); // CONFIGURATION /*! * Emitted when an applet has changed values in its configuration * and wishes for them to be saved at the next save point. As this implies * disk activity, this signal should be used with care. * * \note This does not need to be emitted from saveState by individual * applets. */ void configNeedsSaving(); /*! * emitted when the config ui appears or disappears */ void userConfiguringChanged(bool configuring); // ACTIONS /*! * Emitted just before the contextual actions are about to show * For instance just before the context menu containing the actions * added with setAction() is shown */ void contextualActionsAboutToShow(); /*! * Emitted when activation is requested due to, for example, a global * keyboard shortcut. By default the widget is given focus. */ void activated(); /*! * Emitted when activation is requested due to, for example, middle * click. * \since 6.3 */ void secondaryActivated(); // TODO: fix usage in containment, port to QObject::destroyed /*! * Emitted when the applet is deleted */ void appletDeleted(Plasma::Applet *applet); /*! * Emitted when the formfactor changes */ void formFactorChanged(Plasma::Types::FormFactor formFactor); /*! * Emitted when the location changes */ void locationChanged(Plasma::Types::Location location); /*! * Emitted when the containment display hints change */ void containmentDisplayHintsChanged(Plasma::Types::ContainmentDisplayHints hints); /*! * Emitted when setConfigurationRequired was called * \sa setConfigurationRequired * \since 5.20 */ void configurationRequiredChanged(bool needsConfig, const QString &reason); /*! * Emitted when the applet gains or loses the ability to show a configuration interface * \sa hasConfigurationInterface * \since 6.0 */ void hasConfigurationInterfaceChanged(bool hasConfiguration); /*! * Emitted when the constraint hints changed * \sa setConstraintHints */ void constraintHintsChanged(Plasma::Applet::ConstraintHints constraintHints); /*! * Emitted when the containment changes */ void containmentChanged(Plasma::Containment *containment); /*! * Emitted when the list of contextual actions has changed */ void contextualActionsChanged(const QList &actions); /*! * Emitted when the list of internal actions has changed */ void internalActionsChanged(const QList &actions); // TODO KF6 keep as Q_SLOT only stuff that needs to be manually invocable from qml public Q_SLOTS: // BOOKKEEPING /*! * Call this method when the applet fails to launch properly. An * optional reason can be provided. * * Not that all children items will be deleted when this method is * called. If you have pointers to these items, you will need to * reset them after calling this method. * * \a failed true when the applet failed, false when it succeeded * * \a reason an optional reason to show the user why the applet * failed to launch * \since 5.0 **/ void setLaunchErrorMessage(const QString &reason = QString()); /*! * Sets the immutability type for this applet (not immutable, * user immutable or system immutable) * * \a immutable the new immutability type of this applet */ void setImmutability(const Types::ImmutabilityType immutable); /*! * Destroys the applet; it will be removed nicely and deleted. * Its configuration will also be deleted. * If you want to remove the Applet configuration, use this, don't just delete the Applet * */ void destroy(); /*! * sets the status for this applet * \since 4.4 */ void setStatus(const Types::ItemStatus stat); // CONFIGURATION /*! * Called when applet configuration values have changed. */ virtual void configChanged(); // TODO KF6: make it not a slot anymore and protected // UTILS /*! * Sends all pending constraints updates to the applet. Will usually * be called automatically, but can also be called manually if needed. */ void flushPendingConstraintsEvents(); /*! * This method is called once the applet is loaded and added to a Corona. * If the applet requires a Scene or has an particularly intensive * set of initialization routines to go through, consider implementing it * in this method instead of the constructor. * * \note paintInterface may get called before init() depending on initialization * order. Painting is managed by the canvas (QGraphisScene), and may schedule a * paint event prior to init() being called. **/ virtual void init(); protected: // CONFIGURATION /*! * When called, the Applet should write any information needed as part * of the Applet's running state to the configuration object in config() * and/or globalConfig(). * * Applets that always sync their settings/state with the config * objects when these settings/states change do not need to reimplement * this method. **/ virtual void saveState(KConfigGroup &config) const; // UTILS /*! * Called when any of the constraints for the applet have been updated. These constraints * range from notifying when the applet has officially "started up" to when geometry changes * to when the form factor changes. * * Each constraint that has been changed is passed in the constraints flag. * All of the constraints and how they work is documented in the \sa Plasma::Constraints * enumeration. * * On applet creation, this is always called prior to painting and can be used as an * opportunity to layout the widget, calculate sizings, etc. * * Do not call update() from this method; an update() will be triggered * at the appropriate time for the applet. * * \a constraints the type of constraints that were updated */ virtual void constraintsEvent(Constraints constraints); // TODO: timerEvent should go into AppletPrivate void timerEvent(QTimerEvent *event) override; private: QUrl fileUrl(const QString &filename) const; QUrl mainScript() const; QUrl configModel() const; bool sourceValid() const; QString qrcPath() const; // TODO KF6: drop Q_PRIVATE_SLOT Q_PRIVATE_SLOT(d, void cleanUpAndDelete()) Q_PRIVATE_SLOT(d, void askDestroy()) Q_PRIVATE_SLOT(d, void globalShortcutChanged()) Q_PRIVATE_SLOT(d, void propagateConfigChanged()) Q_PRIVATE_SLOT(d, void requestConfiguration()) AppletPrivate *const d; // Corona needs to access setLaunchErrorMessage and init friend class Corona; friend class CoronaPrivate; friend class Containment; friend class ContainmentPrivate; friend class AppletScript; friend class AppletPrivate; friend class AccessAppletJobPrivate; friend class GraphicsViewAppletPrivate; friend class PluginLoader; friend class SvgPrivate; friend class PlasmaQuick::AppletQuickItem; friend class PlasmaQuick::ConfigModel; friend class PlasmaQuick::ConfigModelPrivate; friend class PlasmaQuick::ConfigViewPrivate; friend class PlasmaQuick::ConfigView; friend DeclarativeAppletScript; }; Q_DECLARE_OPERATORS_FOR_FLAGS(Applet::Constraints) Q_DECLARE_OPERATORS_FOR_FLAGS(Applet::ConstraintHints) } // Plasma namespace #endif // multiple inclusion guard