2008-11-04 00:08:39 +01:00
|
|
|
/*
|
|
|
|
* Copyright 2007 by Aaron Seigo <aseigo@kde.org>
|
|
|
|
* Copyright 2008 by Ménard Alexis <darktears31@gmail.com>
|
2009-08-18 00:31:18 +02:00
|
|
|
* Copyright (c) 2009 Chani Armitage <chani@kde.org>
|
2008-11-04 00:08:39 +01:00
|
|
|
*
|
|
|
|
* This program 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, or
|
|
|
|
* (at your option) any later version.
|
|
|
|
*
|
|
|
|
* This program 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 General Public License for more details
|
|
|
|
*
|
|
|
|
* You should have received a copy of the GNU Library General Public
|
|
|
|
* License along with this program; if not, write to the
|
|
|
|
* Free Software Foundation, Inc.,
|
|
|
|
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
|
|
|
|
*/
|
|
|
|
|
|
|
|
#ifndef PLASMA_CONTAINMENT_H
|
|
|
|
#define PLASMA_CONTAINMENT_H
|
|
|
|
|
2012-02-02 10:35:53 +01:00
|
|
|
#include <QGraphicsItem>
|
|
|
|
#include <QWidget>
|
|
|
|
#include <QStyleOptionGraphicsItem>
|
2008-11-04 00:08:39 +01:00
|
|
|
|
|
|
|
#include <kplugininfo.h>
|
|
|
|
#include <ksharedconfig.h>
|
|
|
|
|
|
|
|
#include <plasma/applet.h>
|
|
|
|
#include <plasma/animator.h>
|
|
|
|
|
Make dropping remote content onto Plasma work
The idea is that you drop a file from a webpage, or basically a URL onto Plasma and Plasma creates a suitable applet to display this URL. For example an image frame for picture, or a previewer for pdf files. Downloading the data itself (and possibly saving it) is left to the applets. The mimetype needs to be retrieved as it cannot be determined from the URL.
The code pathes I've changed or added are, roughly:
- "something" is dropped onto Plasma
- if it's a remote URL, we don't know the mimetype of the object behind the URL yet
- a KIO::TransferJob is used to retrieve the mimetype asynchronously, and will call back
- we open a QMenu that says "Fetching file type..."
- If the user closes the menu while the mimetype is being retrieved, we will open a new one
- When the TransferJob calls back, and we have our mimetype, we offer a list of applets suitable for this kind of content
- If the user chooses to create an applet, we put the transfer job on hold to make it available for recycling by the applet
- If the user dismisses the offering, we kill the job
Thanks to marco for reviewing and everybody else for the input :)
Next steps are making some more applets work with this.
CCMAIL:plasma-devel@kde.org
svn path=/trunk/KDE/kdelibs/; revision=1009004
2009-08-09 00:01:16 +02:00
|
|
|
|
2008-11-04 00:08:39 +01:00
|
|
|
namespace Plasma
|
|
|
|
{
|
|
|
|
|
2009-09-22 17:29:08 +02:00
|
|
|
class AccessAppletJob;
|
2008-11-04 00:08:39 +01:00
|
|
|
class AppletHandle;
|
|
|
|
class DataEngine;
|
|
|
|
class Package;
|
|
|
|
class Corona;
|
|
|
|
class View;
|
|
|
|
class Wallpaper;
|
2009-08-18 00:31:32 +02:00
|
|
|
class ContainmentActions;
|
2008-11-04 00:08:39 +01:00
|
|
|
class ContainmentPrivate;
|
2009-10-20 16:14:53 +02:00
|
|
|
class AbstractToolBox;
|
2008-11-04 00:08:39 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @class Containment plasma/containment.h <Plasma/Containment>
|
|
|
|
*
|
|
|
|
* @short The base class for plugins that provide backgrounds and applet grouping containers
|
|
|
|
*
|
|
|
|
* Containment objects provide the means to group applets into functional sets.
|
|
|
|
* They also provide the following:
|
|
|
|
*
|
|
|
|
* creation of focussing event
|
|
|
|
* - drawing of the background image (which can be interactive)
|
|
|
|
* - form factors (e.g. panel, desktop, full screen, etc)
|
|
|
|
* - applet layout management
|
|
|
|
*
|
|
|
|
* Since containment is actually just a Plasma::Applet, all the techniques used
|
|
|
|
* for writing the visual presentation of Applets is applicable to Containtments.
|
|
|
|
* Containments are differentiated from Applets by being marked with the ServiceType
|
|
|
|
* of Plasma/Containment. Plugins registered with both the Applet and the Containment
|
|
|
|
* ServiceTypes can be loaded for us in either situation.
|
|
|
|
*
|
|
|
|
* See techbase.kde.org for a tutorial on writing Containments using this class.
|
|
|
|
*/
|
|
|
|
class PLASMA_EXPORT Containment : public Applet
|
|
|
|
{
|
|
|
|
Q_OBJECT
|
|
|
|
|
|
|
|
public:
|
2009-01-05 20:56:30 +01:00
|
|
|
class PLASMA_EXPORT StyleOption : public QStyleOptionGraphicsItem
|
2008-11-04 00:08:39 +01:00
|
|
|
{
|
|
|
|
public:
|
|
|
|
explicit StyleOption();
|
|
|
|
explicit StyleOption(const StyleOption &other);
|
|
|
|
explicit StyleOption(const QStyleOptionGraphicsItem &other);
|
|
|
|
|
|
|
|
enum StyleOptionType {
|
|
|
|
Type = SO_CustomBase + 1
|
|
|
|
};
|
|
|
|
enum StyleOptionVersion {
|
|
|
|
Version = QStyleOptionGraphicsItem::Version + 1
|
|
|
|
};
|
|
|
|
|
|
|
|
/**
|
|
|
|
* The View, if any, that this containment is currently
|
|
|
|
* being rendered into. Note: this may be NULL, so be
|
|
|
|
* sure to check it before using it!
|
|
|
|
*/
|
|
|
|
Plasma::View *view;
|
|
|
|
};
|
|
|
|
|
|
|
|
enum Type {
|
|
|
|
NoContainmentType = -1, /**< @internal */
|
|
|
|
DesktopContainment = 0, /**< A desktop containment */
|
|
|
|
PanelContainment, /**< A desktop panel */
|
|
|
|
CustomContainment = 127, /**< A containment that is neither a desktop nor a panel
|
|
|
|
but something application specific */
|
|
|
|
CustomPanelContainment = 128 /**< A customized desktop panel */
|
|
|
|
};
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @param parent the QGraphicsItem this applet is parented to
|
|
|
|
* @param serviceId the name of the .desktop file containing the
|
|
|
|
* information about the widget
|
|
|
|
* @param containmentId a unique id used to differentiate between multiple
|
|
|
|
* instances of the same Applet type
|
|
|
|
*/
|
|
|
|
explicit Containment(QGraphicsItem *parent = 0,
|
|
|
|
const QString &serviceId = QString(),
|
|
|
|
uint containmentId = 0);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* This constructor is to be used with the plugin loading systems
|
|
|
|
* found in KPluginInfo and KService. The argument list is expected
|
|
|
|
* to have two elements: the KService service ID for the desktop entry
|
|
|
|
* and an applet ID which must be a base 10 number.
|
|
|
|
*
|
|
|
|
* @param parent a QObject parent; you probably want to pass in 0
|
|
|
|
* @param args a list of strings containing two entries: the service id
|
|
|
|
* and the applet id
|
|
|
|
*/
|
|
|
|
Containment(QObject *parent, const QVariantList &args);
|
|
|
|
|
|
|
|
~Containment();
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Reimplemented from Applet
|
|
|
|
*/
|
|
|
|
void init();
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Returns the type of containment
|
|
|
|
*/
|
|
|
|
Type containmentType() const;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Returns the Corona (if any) that this Containment is hosted by
|
|
|
|
*/
|
|
|
|
Corona *corona() const;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Returns a list of all known containments.
|
|
|
|
*
|
2009-04-03 02:29:54 +02:00
|
|
|
* @param category Only containments matching this category will be returned.
|
2008-11-04 00:08:39 +01:00
|
|
|
* Useful in conjunction with knownCategories.
|
2009-12-10 10:16:30 +01:00
|
|
|
* If "Miscellaneous" is passed in, then applets without a
|
2008-11-04 00:08:39 +01:00
|
|
|
* Categories= entry are also returned.
|
|
|
|
* If an empty string is passed in, all applets are
|
|
|
|
* returned.
|
|
|
|
* @param parentApp the application to filter applets on. Uses the
|
|
|
|
* X-KDE-ParentApp entry (if any) in the plugin info.
|
|
|
|
* The default value of QString() will result in a
|
|
|
|
* list containing only applets not specifically
|
|
|
|
* registered to an application.
|
|
|
|
* @return list of applets
|
|
|
|
**/
|
|
|
|
static KPluginInfo::List listContainments(const QString &category = QString(),
|
|
|
|
const QString &parentApp = QString());
|
|
|
|
|
2009-04-03 02:29:54 +02:00
|
|
|
/**
|
|
|
|
* Returns a list of all known Containments that match the parameters.
|
|
|
|
*
|
|
|
|
* @param type Only Containments with this string in X-Plasma-ContainmentCategories
|
|
|
|
* in their .desktop files will be returned. Common values are panel and
|
|
|
|
* desktop
|
|
|
|
* @param category Only applets matchin this category will be returned.
|
|
|
|
* Useful in conjunction with knownCategories.
|
2009-12-10 10:16:30 +01:00
|
|
|
* If "Miscellaneous" is passed in, then applets without a
|
2009-04-03 02:29:54 +02:00
|
|
|
* Categories= entry are also returned.
|
|
|
|
* If an empty string is passed in, all applets are
|
|
|
|
* returned.
|
|
|
|
* @param parentApp the application to filter applets on. Uses the
|
|
|
|
* X-KDE-ParentApp entry (if any) in the plugin info.
|
|
|
|
* The default value of QString() will result in a
|
|
|
|
* list containing only applets not specifically
|
|
|
|
* registered to an application.
|
|
|
|
* @return list of applets
|
|
|
|
**/
|
|
|
|
static KPluginInfo::List listContainmentsOfType(const QString &type,
|
|
|
|
const QString &category = QString(),
|
|
|
|
const QString &parentApp = QString());
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @return a list of all known types of Containments on this system
|
|
|
|
*/
|
|
|
|
static QStringList listContainmentTypes();
|
|
|
|
|
2008-11-04 00:08:39 +01:00
|
|
|
/**
|
2011-05-06 12:17:08 +02:00
|
|
|
* Returns a list of all known applets associated with a certain MimeType
|
2008-11-04 00:08:39 +01:00
|
|
|
*
|
|
|
|
* @return list of applets
|
|
|
|
**/
|
2011-05-06 12:17:08 +02:00
|
|
|
static KPluginInfo::List listContainmentsForMimeType(const QString &mimeType);
|
2008-11-04 00:08:39 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Adds an applet to this Containment
|
|
|
|
*
|
|
|
|
* @param name the plugin name for the applet, as given by
|
|
|
|
* KPluginInfo::pluginName()
|
|
|
|
* @param args argument list to pass to the plasmoid
|
|
|
|
* @param geometry where to place the applet, or to auto-place it if an invalid
|
|
|
|
* is provided
|
|
|
|
*
|
|
|
|
* @return a pointer to the applet on success, or 0 on failure
|
|
|
|
*/
|
|
|
|
Applet *addApplet(const QString &name, const QVariantList &args = QVariantList(),
|
2011-11-17 14:40:53 +01:00
|
|
|
const QRectF &geometry = QRectF(-1, -1, -1, -1));
|
2008-11-04 00:08:39 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Add an existing applet to this Containment
|
|
|
|
*
|
|
|
|
* If dontInit is true, the pending constraints are not flushed either.
|
|
|
|
* So it is your responsibility to call both init() and
|
|
|
|
* flushPendingConstraints() on the applet.
|
|
|
|
*
|
|
|
|
* @param applet the applet that should be added
|
|
|
|
* @param pos the containment-relative position
|
|
|
|
* @param dontInit if true, init() will not be called on the applet
|
|
|
|
*/
|
|
|
|
void addApplet(Applet *applet, const QPointF &pos = QPointF(-1, -1), bool dontInit = true);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @return the applets currently in this Containment
|
|
|
|
*/
|
|
|
|
Applet::List applets() const;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Removes all applets from this Containment
|
|
|
|
*/
|
|
|
|
void clearApplets();
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Sets the physical screen this Containment is associated with.
|
|
|
|
*
|
|
|
|
* @param screen the screen number this containment is the desktop for, or -1
|
|
|
|
* if it is not serving as the desktop for any screen
|
2008-11-17 05:34:55 +01:00
|
|
|
* @param desktop the virtual desktop to also associate this this screen with
|
2008-11-04 00:08:39 +01:00
|
|
|
*/
|
2008-11-17 05:34:55 +01:00
|
|
|
void setScreen(int screen, int desktop = -1);
|
2008-11-04 00:08:39 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @return the screen number this containment is serving as the desktop for
|
|
|
|
* or -1 if none
|
|
|
|
*/
|
|
|
|
int screen() const;
|
|
|
|
|
2010-05-19 04:43:07 +02:00
|
|
|
/**
|
|
|
|
* @return the last screen number this containment had
|
|
|
|
* only returns -1 if it's never ever been on a screen
|
|
|
|
* @since 4.5
|
|
|
|
*/
|
|
|
|
int lastScreen() const;
|
|
|
|
|
2008-11-17 05:34:55 +01:00
|
|
|
/**
|
|
|
|
* @return the viewport (e.g. virtual desktop) this Containment is associated with.
|
|
|
|
*/
|
|
|
|
int desktop() const;
|
|
|
|
|
2010-05-19 04:43:07 +02:00
|
|
|
/**
|
|
|
|
* @return the viewport (e.g. virtual desktop) this Containment was associated with
|
|
|
|
* last time it had a screen
|
|
|
|
* @since 4.5
|
|
|
|
*/
|
|
|
|
int lastDesktop() const;
|
|
|
|
|
2008-11-04 00:08:39 +01:00
|
|
|
/**
|
2009-01-10 01:08:31 +01:00
|
|
|
* @reimp
|
|
|
|
* @sa Applet::save(KConfigGroup &)
|
2008-11-04 00:08:39 +01:00
|
|
|
*/
|
|
|
|
void save(KConfigGroup &group) const;
|
|
|
|
|
|
|
|
/**
|
2009-01-10 01:08:31 +01:00
|
|
|
* @reimp
|
|
|
|
* @sa Applet::restore(KConfigGroup &)
|
2008-11-04 00:08:39 +01:00
|
|
|
*/
|
|
|
|
void restore(KConfigGroup &group);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* convenience function - enables or disables an action by name
|
|
|
|
*
|
|
|
|
* @param name the name of the action in our collection
|
|
|
|
* @param enable true to enable, false to disable
|
|
|
|
*/
|
|
|
|
void enableAction(const QString &name, bool enable);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Add an action to the toolbox
|
|
|
|
*/
|
|
|
|
void addToolBoxAction(QAction *action);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Remove an action from the toolbox
|
|
|
|
*/
|
|
|
|
void removeToolBoxAction(QAction *action);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Sets the open or closed state of the Containment's toolbox
|
|
|
|
*
|
2011-06-13 14:47:29 +02:00
|
|
|
* @param open true to open the ToolBox, false to close it
|
2008-11-04 00:08:39 +01:00
|
|
|
*/
|
|
|
|
void setToolBoxOpen(bool open);
|
|
|
|
|
2010-06-09 15:18:04 +02:00
|
|
|
/**
|
|
|
|
* @return true if the toolbox is open
|
|
|
|
* @since 4.5
|
|
|
|
*/
|
|
|
|
bool isToolBoxOpen() const;
|
|
|
|
|
2008-11-04 00:08:39 +01:00
|
|
|
/**
|
|
|
|
* Open the Containment's toolbox
|
|
|
|
*/
|
|
|
|
void openToolBox();
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Closes Containment's toolbox
|
|
|
|
*/
|
|
|
|
void closeToolBox();
|
|
|
|
|
|
|
|
/**
|
|
|
|
* associate actions with this widget, including ones added after this call.
|
|
|
|
* needed to make keyboard shortcuts work.
|
|
|
|
*/
|
|
|
|
void addAssociatedWidget(QWidget *widget);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* un-associate actions from this widget, including ones added after this call.
|
|
|
|
* needed to make keyboard shortcuts work.
|
|
|
|
*/
|
|
|
|
void removeAssociatedWidget(QWidget *widget);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Return whether wallpaper is painted or not.
|
|
|
|
*/
|
|
|
|
bool drawWallpaper();
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Sets wallpaper plugin.
|
|
|
|
*
|
|
|
|
* @param pluginName the name of the wallpaper to attempt to load
|
|
|
|
* @param mode optional mode or the wallpaper plugin (e.g. "Slideshow").
|
|
|
|
* These values are pugin specific and enumerated in the plugin's
|
|
|
|
* .desktop file.
|
|
|
|
*/
|
|
|
|
void setWallpaper(const QString &pluginName, const QString &mode = QString());
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Return wallpaper plugin.
|
|
|
|
*/
|
|
|
|
Plasma::Wallpaper *wallpaper() const;
|
|
|
|
|
|
|
|
/**
|
2011-05-20 09:41:19 +02:00
|
|
|
* Sets the current activity by id
|
2008-11-04 00:08:39 +01:00
|
|
|
*
|
2011-05-20 09:41:19 +02:00
|
|
|
* @param activity the id of the activity
|
2008-11-04 00:08:39 +01:00
|
|
|
*/
|
2011-05-20 09:41:19 +02:00
|
|
|
void setActivity(const QString &activityId);
|
2008-11-04 00:08:39 +01:00
|
|
|
|
|
|
|
/**
|
2011-05-20 09:41:19 +02:00
|
|
|
* @return the current activity id associated with this containment
|
2008-11-04 00:08:39 +01:00
|
|
|
*/
|
|
|
|
QString activity() const;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Shows the context menu for the containment directly, bypassing Applets
|
|
|
|
* altogether.
|
|
|
|
*/
|
|
|
|
void showContextMenu(const QPointF &containmentPos, const QPoint &screenPos);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Shows a visual clue for drag and drop
|
2008-11-06 16:51:28 +01:00
|
|
|
* The default implementation does nothing,
|
|
|
|
* reimplement in containments that need it
|
2008-11-04 00:08:39 +01:00
|
|
|
*
|
2008-11-06 16:51:28 +01:00
|
|
|
* @param pos point where to show the drop target; if an invalid point is passed in
|
|
|
|
* the drop zone should not be shown
|
2008-11-04 00:08:39 +01:00
|
|
|
*/
|
|
|
|
virtual void showDropZone(const QPoint pos);
|
|
|
|
|
2009-08-18 00:30:34 +02:00
|
|
|
/**
|
2009-08-18 00:31:32 +02:00
|
|
|
* Sets a containmentactions plugin.
|
2009-08-18 00:30:34 +02:00
|
|
|
*
|
|
|
|
* @param trigger the mouse button (and optional modifier) to associate the plugin with
|
|
|
|
* @param pluginName the name of the plugin to attempt to load. blank = set no plugin.
|
2009-08-18 00:31:32 +02:00
|
|
|
* @since 4.4
|
2009-08-18 00:30:34 +02:00
|
|
|
*/
|
2009-08-18 00:31:32 +02:00
|
|
|
void setContainmentActions(const QString &trigger, const QString &pluginName);
|
2009-08-18 00:30:34 +02:00
|
|
|
|
2009-08-18 00:30:38 +02:00
|
|
|
/**
|
2009-08-18 00:31:32 +02:00
|
|
|
* @return a list of all triggers that have a containmentactions plugin associated
|
|
|
|
* @since 4.4
|
2009-08-18 00:30:38 +02:00
|
|
|
*/
|
2009-08-18 00:31:32 +02:00
|
|
|
QStringList containmentActionsTriggers();
|
2009-08-18 00:30:38 +02:00
|
|
|
|
|
|
|
/**
|
2009-08-18 00:31:18 +02:00
|
|
|
* @return the plugin name for the given trigger
|
2009-08-18 00:31:32 +02:00
|
|
|
* @since 4.4
|
2009-08-18 00:30:38 +02:00
|
|
|
*/
|
2009-08-18 00:31:32 +02:00
|
|
|
QString containmentActions(const QString &trigger);
|
2009-08-18 00:30:38 +02:00
|
|
|
|
2010-11-11 23:22:39 +01:00
|
|
|
/**
|
|
|
|
* @return the config group that containmentactions plugins go in
|
|
|
|
* @since 4.6
|
|
|
|
*/
|
|
|
|
KConfigGroup containmentActionsConfig();
|
|
|
|
|
|
|
|
Q_SIGNALS:
|
2008-11-04 00:08:39 +01:00
|
|
|
/**
|
|
|
|
* This signal is emitted when a new applet is created by the containment
|
|
|
|
*/
|
|
|
|
void appletAdded(Plasma::Applet *applet, const QPointF &pos);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* This signal is emitted when an applet is destroyed
|
|
|
|
*/
|
|
|
|
void appletRemoved(Plasma::Applet *applet);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Emitted when the user clicks on the toolbox
|
|
|
|
*/
|
|
|
|
void toolBoxToggled();
|
|
|
|
|
2009-04-13 22:26:17 +02:00
|
|
|
/**
|
|
|
|
* Emitted when the toolbox is hidden or shown
|
|
|
|
* @since 4.3
|
|
|
|
*/
|
|
|
|
void toolBoxVisibilityChanged(bool);
|
|
|
|
|
2008-11-04 00:08:39 +01:00
|
|
|
/**
|
|
|
|
* Emitted when the containment wants a new containment to be created.
|
|
|
|
* Usually only used for desktop containments.
|
|
|
|
*/
|
|
|
|
void addSiblingContainment(Plasma::Containment *);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Emitted when the containment requests an add widgets dialog is shown.
|
|
|
|
* Usually only used for desktop containments.
|
|
|
|
*
|
|
|
|
* @param pos where in the containment this request was made from, or
|
|
|
|
* an invalid position (QPointF()) is not location specific
|
|
|
|
*/
|
|
|
|
void showAddWidgetsInterface(const QPointF &pos);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* This signal indicates that a containment has been newly
|
|
|
|
* associated (or dissociated) with a physical screen.
|
|
|
|
*
|
|
|
|
* @param wasScreen the screen it was associated with
|
|
|
|
* @param isScreen the screen it is now associated with
|
|
|
|
* @param containment the containment switching screens
|
|
|
|
*/
|
|
|
|
void screenChanged(int wasScreen, int isScreen, Plasma::Containment *containment);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Emitted when the user wants to configure/change containment.
|
|
|
|
*/
|
|
|
|
void configureRequested(Plasma::Containment *containment);
|
|
|
|
|
|
|
|
public Q_SLOTS:
|
|
|
|
/**
|
|
|
|
* Informs the Corona as to what position it is in. This is informational
|
2009-07-26 17:22:59 +02:00
|
|
|
* only, as the Corona doesn't change its actual location. This is,
|
2008-11-04 00:08:39 +01:00
|
|
|
* however, passed on to Applets that may be managed by this Corona.
|
|
|
|
*
|
|
|
|
* @param location the new location of this Corona
|
|
|
|
*/
|
|
|
|
void setLocation(Plasma::Location location);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Sets the form factor for this Containment. This may cause changes in both
|
|
|
|
* the arrangement of Applets as well as the display choices of individual
|
|
|
|
* Applets.
|
|
|
|
*/
|
|
|
|
void setFormFactor(Plasma::FormFactor formFactor);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Tells the corona to create a new desktop containment
|
|
|
|
*/
|
|
|
|
void addSiblingContainment();
|
|
|
|
|
|
|
|
/**
|
|
|
|
* switch keyboard focus to the next of our applets
|
|
|
|
*/
|
|
|
|
void focusNextApplet();
|
|
|
|
|
|
|
|
/**
|
|
|
|
* switch keyboard focus to the previous one of our applets
|
|
|
|
*/
|
|
|
|
void focusPreviousApplet();
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Destroys this containment and all its applets (after a confirmation dialog);
|
|
|
|
* it will be removed nicely and deleted.
|
|
|
|
* Its configuration will also be deleted.
|
|
|
|
*/
|
|
|
|
void destroy();
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Destroys this containment and all its applets (after a confirmation dialog);
|
|
|
|
* it will be removed nicely and deleted.
|
|
|
|
* Its configuration will also be deleted.
|
|
|
|
*
|
2011-06-13 14:47:29 +02:00
|
|
|
* @param confirm whether or not confirmation from the user should be requested
|
2008-11-04 00:08:39 +01:00
|
|
|
*/
|
|
|
|
void destroy(bool confirm);
|
|
|
|
|
|
|
|
/**
|
2009-01-10 01:08:31 +01:00
|
|
|
* @reimp
|
|
|
|
* @sa Applet::showConfigurationInterface()
|
2008-11-04 00:08:39 +01:00
|
|
|
*/
|
|
|
|
void showConfigurationInterface();
|
2008-11-10 02:26:27 +01:00
|
|
|
|
2008-11-04 00:08:39 +01:00
|
|
|
/**
|
|
|
|
* Sets the type of this containment.
|
|
|
|
*/
|
|
|
|
void setContainmentType(Containment::Type type);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Sets whether wallpaper is painted or not.
|
|
|
|
*/
|
|
|
|
void setDrawWallpaper(bool drawWallpaper);
|
|
|
|
|
2011-11-17 14:50:36 +01:00
|
|
|
protected:
|
2008-11-04 00:08:39 +01:00
|
|
|
/**
|
|
|
|
* Called when the contents of the containment should be saved. By default this saves
|
|
|
|
* all loaded Applets
|
|
|
|
*
|
|
|
|
* @param group the KConfigGroup to save settings under
|
|
|
|
*/
|
|
|
|
virtual void saveContents(KConfigGroup &group) const;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Called when the contents of the containment should be loaded. By default this loads
|
|
|
|
* all previously saved Applets
|
|
|
|
*
|
|
|
|
* @param group the KConfigGroup to save settings under
|
|
|
|
*/
|
|
|
|
virtual void restoreContents(KConfigGroup &group);
|
|
|
|
|
|
|
|
void mouseMoveEvent(QGraphicsSceneMouseEvent *event);
|
|
|
|
void mousePressEvent(QGraphicsSceneMouseEvent *event);
|
|
|
|
void mouseReleaseEvent(QGraphicsSceneMouseEvent *event);
|
|
|
|
void contextMenuEvent(QGraphicsSceneContextMenuEvent *event);
|
|
|
|
void keyPressEvent(QKeyEvent *event);
|
|
|
|
void wheelEvent(QGraphicsSceneWheelEvent *event);
|
|
|
|
QVariant itemChange(GraphicsItemChange change, const QVariant &value);
|
|
|
|
|
|
|
|
/**
|
2009-01-10 01:08:31 +01:00
|
|
|
* @reimp
|
|
|
|
* @sa QGraphicsItem::dragEnterEvent()
|
2008-11-04 00:08:39 +01:00
|
|
|
*/
|
|
|
|
void dragEnterEvent(QGraphicsSceneDragDropEvent *event);
|
|
|
|
|
2009-10-23 00:14:22 +02:00
|
|
|
/**
|
|
|
|
* @reimp
|
|
|
|
* @sa QGraphicsItem::dragLeaveEvent()
|
|
|
|
*/
|
|
|
|
void dragLeaveEvent(QGraphicsSceneDragDropEvent *event);
|
|
|
|
|
2008-11-04 00:08:39 +01:00
|
|
|
/**
|
2009-01-10 01:08:31 +01:00
|
|
|
* @reimp
|
|
|
|
* @sa QGraphicsItem::dragMoveEvent()
|
2008-11-04 00:08:39 +01:00
|
|
|
*/
|
|
|
|
void dragMoveEvent(QGraphicsSceneDragDropEvent *event);
|
|
|
|
|
|
|
|
/**
|
2009-01-10 01:08:31 +01:00
|
|
|
* @reimp
|
|
|
|
* @sa QGraphicsItem::dropEvent()
|
2008-11-04 00:08:39 +01:00
|
|
|
*/
|
|
|
|
void dropEvent(QGraphicsSceneDragDropEvent *event);
|
|
|
|
|
|
|
|
/**
|
2009-01-10 01:08:31 +01:00
|
|
|
* @reimp
|
|
|
|
* @sa QGraphicsItem::resizeEvent()
|
2008-11-04 00:08:39 +01:00
|
|
|
*/
|
|
|
|
void resizeEvent(QGraphicsSceneResizeEvent *event);
|
|
|
|
|
2009-10-20 16:14:53 +02:00
|
|
|
/**
|
|
|
|
* Sets a custom ToolBox
|
|
|
|
* if there was an old one it will be deleted
|
|
|
|
* and the new one won't have any actions in it
|
|
|
|
*
|
|
|
|
* @param item the new toolbox item
|
|
|
|
* @since 4.4
|
|
|
|
*/
|
|
|
|
void setToolBox(AbstractToolBox *toolBox);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @return the ToolBox
|
|
|
|
* @since 4.4
|
|
|
|
*/
|
|
|
|
AbstractToolBox *toolBox() const;
|
2008-11-18 21:49:42 +01:00
|
|
|
|
2008-11-04 00:08:39 +01:00
|
|
|
private:
|
2009-10-23 15:48:29 +02:00
|
|
|
/**
|
|
|
|
* @internal This constructor is to be used with the Package loading system.
|
|
|
|
*
|
|
|
|
* @param parent a QObject parent; you probably want to pass in 0
|
|
|
|
* @param args a list of strings containing two entries: the service id
|
|
|
|
* and the applet id
|
|
|
|
* @since 4.3
|
|
|
|
*/
|
|
|
|
Containment(const QString &packagePath, uint appletId, const QVariantList &args);
|
|
|
|
|
2009-01-28 08:58:17 +01:00
|
|
|
Q_PRIVATE_SLOT(d, void appletDestroyed(Plasma::Applet*))
|
2008-11-04 00:08:39 +01:00
|
|
|
Q_PRIVATE_SLOT(d, void triggerShowAddWidgets())
|
|
|
|
Q_PRIVATE_SLOT(d, void positionToolBox())
|
2008-11-10 02:26:27 +01:00
|
|
|
Q_PRIVATE_SLOT(d, void requestConfiguration())
|
2009-04-24 21:27:58 +02:00
|
|
|
Q_PRIVATE_SLOT(d, void updateToolBoxVisibility())
|
2009-10-23 00:14:22 +02:00
|
|
|
Q_PRIVATE_SLOT(d, void showDropZoneDelayed())
|
2010-05-06 00:33:52 +02:00
|
|
|
Q_PRIVATE_SLOT(d, void checkStatus(Plasma::ItemStatus))
|
2009-09-22 21:35:21 +02:00
|
|
|
Q_PRIVATE_SLOT(d, void remoteAppletReady(Plasma::AccessAppletJob *))
|
Make dropping remote content onto Plasma work
The idea is that you drop a file from a webpage, or basically a URL onto Plasma and Plasma creates a suitable applet to display this URL. For example an image frame for picture, or a previewer for pdf files. Downloading the data itself (and possibly saving it) is left to the applets. The mimetype needs to be retrieved as it cannot be determined from the URL.
The code pathes I've changed or added are, roughly:
- "something" is dropped onto Plasma
- if it's a remote URL, we don't know the mimetype of the object behind the URL yet
- a KIO::TransferJob is used to retrieve the mimetype asynchronously, and will call back
- we open a QMenu that says "Fetching file type..."
- If the user closes the menu while the mimetype is being retrieved, we will open a new one
- When the TransferJob calls back, and we have our mimetype, we offer a list of applets suitable for this kind of content
- If the user chooses to create an applet, we put the transfer job on hold to make it available for recycling by the applet
- If the user dismisses the offering, we kill the job
Thanks to marco for reviewing and everybody else for the input :)
Next steps are making some more applets work with this.
CCMAIL:plasma-devel@kde.org
svn path=/trunk/KDE/kdelibs/; revision=1009004
2009-08-09 00:01:16 +02:00
|
|
|
/**
|
|
|
|
* This slot is called when the 'stat' after a job event has finished.
|
|
|
|
*/
|
|
|
|
Q_PRIVATE_SLOT(d, void mimeTypeRetrieved(KIO::Job *, const QString &))
|
2009-09-30 23:42:05 +02:00
|
|
|
Q_PRIVATE_SLOT(d, void dropJobResult(KJob *))
|
Make dropping remote content onto Plasma work
The idea is that you drop a file from a webpage, or basically a URL onto Plasma and Plasma creates a suitable applet to display this URL. For example an image frame for picture, or a previewer for pdf files. Downloading the data itself (and possibly saving it) is left to the applets. The mimetype needs to be retrieved as it cannot be determined from the URL.
The code pathes I've changed or added are, roughly:
- "something" is dropped onto Plasma
- if it's a remote URL, we don't know the mimetype of the object behind the URL yet
- a KIO::TransferJob is used to retrieve the mimetype asynchronously, and will call back
- we open a QMenu that says "Fetching file type..."
- If the user closes the menu while the mimetype is being retrieved, we will open a new one
- When the TransferJob calls back, and we have our mimetype, we offer a list of applets suitable for this kind of content
- If the user chooses to create an applet, we put the transfer job on hold to make it available for recycling by the applet
- If the user dismisses the offering, we kill the job
Thanks to marco for reviewing and everybody else for the input :)
Next steps are making some more applets work with this.
CCMAIL:plasma-devel@kde.org
svn path=/trunk/KDE/kdelibs/; revision=1009004
2009-08-09 00:01:16 +02:00
|
|
|
|
2008-11-04 00:08:39 +01:00
|
|
|
friend class Applet;
|
|
|
|
friend class AppletPrivate;
|
|
|
|
friend class CoronaPrivate;
|
|
|
|
friend class ContainmentPrivate;
|
2009-08-18 00:31:32 +02:00
|
|
|
friend class ContainmentActions;
|
2009-10-01 01:07:42 +02:00
|
|
|
friend class PopupApplet;
|
2008-11-04 00:08:39 +01:00
|
|
|
ContainmentPrivate *const d;
|
|
|
|
};
|
|
|
|
|
|
|
|
} // Plasma namespace
|
|
|
|
|
|
|
|
#endif // multiple inclusion guard
|