You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
tdebase/libkonq/konq_popupmenu.h

228 lines
7.5 KiB

/* This file is part of the KDE project
Copyright (C) 1998, 1999 David Faure <faure@kde.org>
Copyright (C) 2001 Holger Freyther <freyther@yahoo.com>
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 __konqpopupmenu_h
#define __konqpopupmenu_h
#include <sys/types.h>
#include <tqpopupmenu.h>
#include <tqmap.h>
#include <tdeaction.h>
#include <tqstringlist.h>
#include <tdefileitem.h>
#include <kmimetype.h> // for KDEDesktopMimeType
#include <libkonq_export.h>
#include <tdeparts/browserextension.h>
#include <tdeio/jobclasses.h>
#include "konq_xmlguiclient.h"
typedef TQValueList<KDEDesktopMimeType::Service> ServiceList;
class KPropertiesDialog;
class KNewMenu;
class KService;
class KonqPopupMenuPlugin;
class KBookmarkManager;
// TODO KDE4: change base class to TDEPopupMenu, see TDEAction::slotPopupActivated()
/**
* This class implements the popup menu for URLs in konqueror and kdesktop
* It's usage is very simple : on right click, create the KonqPopupMenu instance
* with the correct arguments, then exec() to make it appear, then destroy it.
*
*/
class LIBKONQ_EXPORT KonqPopupMenu : public TQPopupMenu, public KonqXMLGUIClient
{
Q_OBJECT
public:
/**
* Flags set by the calling application (konqueror/kdesktop), unlike
* KParts::BrowserExtension::PopupFlags, which are set by the calling part
*/
typedef uint KonqPopupFlags;
enum { NoFlags = 0,
ShowProperties = 1, ///< whether to show the "Properties" menu item
IsLink = 2, ///< HTML link. If set, we won't have cut/copy/paste, and we'll say "bookmark this link"
ShowNewWindow = 4 };
// WARNING: bitfield. Next item is 8
/**
* @deprecated lacks parentWidget pointer, and
* uses bool instead of KonqPopupFlags enum,
* might do strange things with the 'new window' action.
*/
KonqPopupMenu( KBookmarkManager* manager,
const KFileItemList &items,
KURL viewURL,
TDEActionCollection & actions,
KNewMenu * newMenu,
bool showPropertiesAndFileType = true ) KDE_DEPRECATED;
/**
* @deprecated uses bool instead of KonqPopupFlags enum,
* might do strange things with the 'new window' action.
*/
KonqPopupMenu( KBookmarkManager* manager,
const KFileItemList &items,
KURL viewURL,
TDEActionCollection & actions,
KNewMenu * newMenu,
TQWidget * parentWidget,
bool showPropertiesAndFileType = true ) KDE_DEPRECATED;
/**
* Constructor
* @param manager the bookmark manager for this bookmark
* @param items the list of file items the popupmenu should be shown for
* @param viewURL the URL shown in the view, to test for RMB click on view background
* @param actions list of actions the caller wants to see in the menu
* @param newMenu "New" menu, shared with the File menu, in konqueror
* @param parentWidget the widget we're showing this popup for. Helps destroying
* the popup if the widget is destroyed before the popup.
* @param kpf flags from the KonqPopupFlags enum, set by the calling application
* @param f flags from the BrowserExtension enum, set by the calling part
*
* The actions to pass in include :
* showmenubar, back, forward, up, cut, copy, paste, pasteto, trash, rename, del
* The others items are automatically inserted.
*
* @since 3.2
*
* @todo that list is probably not be up-to-date
*/
KonqPopupMenu( KBookmarkManager* manager,
const KFileItemList &items,
const KURL& viewURL,
TDEActionCollection & actions,
KNewMenu * newMenu,
TQWidget * parentWidget,
KonqPopupFlags kpf,
KParts::BrowserExtension::PopupFlags f /*= KParts::BrowserExtension::DefaultPopupItems*/);
/**
* Don't forget to destroy the object
*/
~KonqPopupMenu();
/**
* Set the title of the URL, when the popupmenu is opened for a single URL.
* This is used if the user chooses to add a bookmark for this URL.
*/
void setURLTitle( const TQString& urlTitle );
class LIBKONQ_EXPORT ProtocolInfo {
public:
ProtocolInfo();
bool supportsReading() const;
bool supportsWriting() const;
bool supportsDeleting() const;
bool supportsMoving() const;
bool trashIncluded() const;
private:
friend class KonqPopupMenu;
bool m_Reading:1;
bool m_Writing:1;
bool m_Deleting:1;
bool m_Moving:1;
bool m_TrashIncluded:1;
};
/**
* Reimplemented for internal purpose
*/
virtual TDEAction *action( const TQDomElement &element ) const;
virtual TDEActionCollection *actionCollection() const;
TQString mimeType( ) const;
KURL url( ) const;
KFileItemList fileItemList() const;
KURL::List popupURLList( ) const;
ProtocolInfo protocolInfo() const;
public slots: // KDE4: why public?
void slotPopupNewDir();
void slotPopupNewView();
void slotPopupEmptyTrashBin();
void slotPopupRestoreTrashedItems();
void slotPopupOpenWith();
void slotPopupAddToBookmark();
void slotRunService();
void slotPopupMimeType();
void slotPopupProperties();
void slotOpenShareFileDialog();
protected:
TDEActionCollection &m_actions;
TDEActionCollection m_ownActions;
private slots:
void slotLocalURL( TDEIO::LocalURLJob *, const KURL&, bool );
void slotLocalURLKIODestroyed( );
private:
void init (TQWidget * parentWidget, KonqPopupFlags kpf, KParts::BrowserExtension::PopupFlags itemFlags);
void setup(KonqPopupFlags kpf);
void addPlugins( );
int insertServicesSubmenus(const TQMap<TQString, ServiceList>& list, TQDomElement& menu, bool isBuiltin);
int insertServices(const ServiceList& list, TQDomElement& menu, bool isBuiltin);
bool KIOSKAuthorizedAction(TDEConfig& cfg);
KPropertiesDialog* showPropertiesDialog();
class KonqPopupMenuPrivate;
KonqPopupMenuPrivate *d;
KNewMenu *m_pMenuNew;
KURL m_sViewURL;
TQString m_sMimeType;
KFileItemList m_lstItems;
KURL::List m_lstPopupURLs;
TQMap<int,KService::Ptr> m_mapPopup;
TQMap<int,KDEDesktopMimeType::Service> m_mapPopupServices;
bool m_bHandleEditOperations;
KXMLGUIFactory *m_factory;
KXMLGUIBuilder *m_builder;
TQString attrName;
ProtocolInfo m_info;
TQPtrList<KonqPopupMenuPlugin> m_pluginList;
KBookmarkManager* m_pManager;
};
class LIBKONQ_EXPORT KonqPopupMenuPlugin : public TQObject, public KonqXMLGUIClient {
Q_OBJECT
public:
/**
* Constructor
* If you want to insert a dynamic item or menu to konqpopupmenu
* this class is the right choice.
* Create a TDEAction and use _popup->addAction(new TDEAction );
* If you want to create a submenu use _popup->addGroup( );
*/
KonqPopupMenuPlugin( KonqPopupMenu *_popup, const char *name ); // this should also be the parent
virtual ~KonqPopupMenuPlugin ( );
};
#endif