summaryrefslogtreecommitdiffstats
path: root/kio/kfile/kdirselectdialog.h
diff options
context:
space:
mode:
Diffstat (limited to 'kio/kfile/kdirselectdialog.h')
-rw-r--r--kio/kfile/kdirselectdialog.h131
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