kget/ui/newtransferdialog.h

   1 /* This file is part of the KDE project
   2
   3    Copyright (C) 2005 Dario Massarin <nekkar@libero.it>
   4    Copyright (C) 2007 by Javier Goday <jgoday@gmail.com>
   5    Copyright (C) 2008 by Lukas Appelhans <l.appelhans@gmx.de>
   6
   7    This program is free software; you can redistribute it and/or
   8    modify it under the terms of the GNU General Public
   9    License as published by the Free Software Foundation; either
  10    version 2 of the License, or (at your option) any later version.
  11 */
  12
  13 #ifndef NEW_TRANSFER_DIALOG_H
  14 #define NEW_TRANSFER_DIALOG_H
  15
  16 #include <KDialog>
  17 #include <KUrl>
  18
  19 #include "ui_newtransferwidget.h"
  20
  21 /**
  22 * Dialog to allow add one or more transfers to kget.
  23 * If only one transfer is added then the dialog shows a KUrlRequester.
  24 * If a list of transfers are added then the dialog shows a KListWidget (multiple = true)
  25 * with the transfers as checkable items.
  26 * Also display a KUrlComboRequester for the destination file (or folder if multiple = true)
  27 * And a QComboBox with the groups of transfer in case there are more than one
  28 *
  29 * This class is a singleton, only one instance is allowed.
  30 * If a source is added and the dialog is already showed,
  31 * the dialog becomes multiple and shows the KListWidget
  32 * adding the new transfer to the list of previous ones.
  33 */
  34 class NewTransferDialog : public KDialog, Ui::NewTransferWidget
  35 {
  36     Q_OBJECT
  37 public:
  38     NewTransferDialog(QWidget *parent = 0);
  39     ~NewTransferDialog();
  40
  41     /**
  42     * Returns the current instance of the 'new transfer' dialog
  43     */
  44     static NewTransferDialog *instance(QWidget *parent = 0);
  45
  46     /**
  47     * Shows the dialog adding one transfer url.
  48     * If the dialog is already displayed,
  49     * then add the url to the others or other transfer,
  50     * and displayed the sources as a listWidget (multiple = true)
  51     */
  52     void showDialog(const QString &srcUrl = QString());
  53
  54     /**
  55     * Shows the dialog adding one url list transfers
  56     */
  57     void showDialog(const KUrl::List &list);
  58
  59 public slots:
  60     /**
  61     * Called when the transfer group or the urlREquester changed, the dialog sets the default destination
  62     * for transfers in the new group
  63     */
  64     void setDefaultDestination();
  65
  66 private:
  67     void prepareDialog();
  68     void resizeDialog();
  69
  70     class Private;
  71     NewTransferDialog::Private *d;
  72     QWidget *m_window;
  73     KUrl::List m_sources;
  74 };
  75
  76 #endif