apps/lib/konq/knewmenu.h

   1 /* This file is part of the KDE project
   2    Copyright (C) 1998-2006 David Faure <faure@kde.org>
   3                  2003      Sven Leiber <s.leiber@web.de>
   4
   5    This library is free software; you can redistribute it and/or
   6    modify it under the terms of the GNU Library General Public
   7    License version 2 as published by the Free Software Foundation.
   8
   9    This library is distributed in the hope that it will be useful,
  10    but WITHOUT ANY WARRANTY; without even the implied warranty of
  11    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  12    Library General Public License for more details.
  13
  14    You should have received a copy of the GNU Library General Public License
  15    along with this library; see the file COPYING.LIB.  If not, write to
  16    the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
  17    Boston, MA 02110-1301, USA.
  18 */
  19
  20 #ifndef KNEWMENU_H
  21 #define KNEWMENU_H
  22
  23 #include <kactionmenu.h>
  24 #include <kurl.h>
  25 #include <libkonq_export.h>
  26
  27 class KJob;
  28 namespace KIO { class Job; }
  29
  30 class KActionCollection;
  31
  32 /**
  33  * The 'New' submenu, both for the File menu and the RMB popup menu.
  34  * (The same instance can be used by both).
  35  * It fills the menu with 'Folder' and one item per installed template.
  36  *
  37  * To use this class, you need to connect aboutToShow() of the File menu
  38  * with slotCheckUpToDate() and to call slotCheckUpToDate() before showing
  39  * the RMB popupmenu.
  40  *
  41  * KNewMenu automatically updates the list of templates shown if installed templates
  42  * are added/updated/deleted.
  43  *
  44  * @author David Faure <faure@kde.org>
  45  * Ideas and code for the new template handling mechanism ('link' desktop files)
  46  * from Christoph Pickart <pickart@iam.uni-bonn.de>
  47  */
  48 class LIBKONQ_EXPORT KNewMenu : public KActionMenu
  49 {
  50   Q_OBJECT
  51 public:
  52
  53     /**
  54      * Constructor
  55      * @param name action name, when adding the action to the collection
  56      */
  57     KNewMenu( KActionCollection * parent, QWidget* parentWidget, const QString& name );
  58     virtual ~KNewMenu();
  59
  60     /**
  61      * Set the files the popup is shown for
  62      * Call this before showing up the menu
  63      */
  64     void setPopupFiles(const KUrl::List& files);
  65
  66 public Q_SLOTS:
  67     /**
  68      * Checks if updating the list is necessary
  69      * IMPORTANT : Call this in the slot for aboutToShow.
  70      */
  71     void slotCheckUpToDate();
  72
  73 protected Q_SLOTS:
  74     /**
  75      * Called when the job that copied the template has finished.
  76      * This method is virtual so that error handling can be reimplemented.
  77      * Make sure to call the base class slotResult when !job->error() though.
  78      */
  79     virtual void slotResult( KJob* job );
  80
  81 private Q_SLOTS:
  82     /**
  83      * Called when New->* is clicked
  84      */
  85     void slotActionTriggered(QAction*);
  86
  87     /**
  88      * Fills the templates list.
  89      */
  90     void slotFillTemplates();
  91
  92     // Special case (filename conflict when creating a link=url file)
  93     void slotRenamed( KIO::Job *, const KUrl&, const KUrl& );
  94
  95 private:
  96     void newDir();
  97
  98     /**
  99      * Fills the menu from the templates list.
 100      */
 101     void fillMenu();
 102
 103     /**
 104      * Opens the desktop files and completes the Entry list
 105      * Input: the entry list. Output: the entry list ;-)
 106      */
 107     void parseFiles();
 108
 109     /**
 110      * Make the main menus on the startup.
 111      */
 112     void makeMenus();
 113
 114     /**
 115      * For entryType
 116      * LINKTOTEMPLATE: a desktop file that points to a file or dir to copy
 117      * TEMPLATE: a real file to copy as is (the KDE-1.x solution)
 118      * SEPARATOR: to put a separator in the menu
 119      * 0 means: not parsed, i.e. we don't know
 120      */
 121     enum { LINKTOTEMPLATE = 1, TEMPLATE, SEPARATOR };
 122
 123     class KNewMenuPrivate;
 124     KNewMenuPrivate* d;
 125 };
 126
 127 #endif