diff options
Diffstat (limited to 'kio/kfile/kdirselectdialog.h')
-rw-r--r-- | kio/kfile/kdirselectdialog.h | 131 |
1 files changed, 131 insertions, 0 deletions
diff --git a/kio/kfile/kdirselectdialog.h b/kio/kfile/kdirselectdialog.h new file mode 100644 index 000000000..7f2bb13c5 --- /dev/null +++ b/kio/kfile/kdirselectdialog.h @@ -0,0 +1,131 @@ +/* + Copyright (C) 2001 Michael Jarrett <michaelj@corel.com> + Copyright (C) 2001 Carsten Pfeiffer <pfeiffer@kde.org> + + This library is free software; you can redistribute it and/or + modify it under the terms of the GNU Library General Public + License version 2 as published by the Free Software Foundation. + + 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 KDIRSELECTDIALOG_H +#define KDIRSELECTDIALOG_H + +#include <kdialogbase.h> +#include <kurl.h> + +class QPopupMenu; +class QVBoxLayout; +class KConfig; +class KFileTreeBranch; +class KFileTreeView; +class KFileTreeViewItem; +class KToggleAction; + +/** + * A pretty dialog for a KDirSelect control for selecting directories. + * @author Michael Jarrett <michaelj@corel.com> + * @see KFileDialog + */ +class KIO_EXPORT KDirSelectDialog : public KDialogBase +{ + Q_OBJECT + +public: + /** + * The constructor. Creates a dialog to select a directory (url). + * @internal use the static selectDirectory function + * @param startDir the directory, initially shown + * @param localOnly unused. You can only select paths below the startDir + * @param parent the parent for the dialog, usually 0L + * @param name the QObject::name + * @param modal if the dialog is modal or not + */ + KDirSelectDialog(const QString& startDir = QString::null, + bool localOnly = false, + QWidget *parent = 0L, + const char *name = 0, bool modal = false); + + /** + */ + ~KDirSelectDialog(); + + /** + * Returns the currently-selected URL, or a blank URL if none is selected. + * @return The currently-selected URL, if one was selected. + */ + KURL url() const; + + KFileTreeView * view() const { return m_treeView; } + + bool localOnly() const { return m_localOnly; } + + /** + * Creates a KDirSelectDialog, and returns the result. + * @param startDir the directory, initially shown + * The tree will display this directory and subdirectories of it. + * @param localOnly unused. You can only select paths below the startDir + * @param parent the parent widget to use for the dialog, or NULL to create a parent-less dialog + * @param caption the caption to use for the dialog, or QString::null for the default caption + * @return The URL selected, or an empty URL if the user canceled + * or no URL was selected. + */ + static KURL selectDirectory( const QString& startDir = QString::null, + bool localOnly = false, QWidget *parent = 0L, + const QString& caption = QString::null); + + /** + * @return The path for the root node + */ + QString startDir() const { return m_startDir; } + +public slots: + void setCurrentURL( const KURL& url ); + +protected slots: + virtual void slotUser1(); + +protected: + virtual void accept(); + + // Layouts protected so that subclassing is easy + QVBoxLayout *m_mainLayout; + QString m_startDir; + +private slots: + void slotCurrentChanged(); + void slotURLActivated( const QString& ); + void slotNextDirToList( KFileTreeViewItem *dirItem ); + void slotComboTextChanged( const QString& text ); + void slotContextMenu( KListView *, QListViewItem *, const QPoint & ); + void slotShowHiddenFoldersToggled(); + void slotMkdir(); + +private: + void readConfig( KConfig *config, const QString& group ); + void saveConfig( KConfig *config, const QString& group ); + void openNextDir( KFileTreeViewItem *parent ); + KFileTreeBranch * createBranch( const KURL& url ); + + KFileTreeView *m_treeView; + QPopupMenu *m_contextMenu; + KToggleAction *m_showHiddenFolders; + bool m_localOnly; + +protected: + virtual void virtual_hook( int id, void* data ); +private: + class KDirSelectDialogPrivate; + KDirSelectDialogPrivate *d; +}; + +#endif |