KDirSelectDialog Class Reference

A pretty dialog for a KDirSelect control for selecting directories. More...

#include <kdirselectdialog.h>

Inheritance diagram for KDirSelectDialog:

List of all members.

Public Slots
void	setCurrentUrl (const KUrl &url)
Public Member Functions
	KDirSelectDialog (const KUrl &startDir=KUrl(), bool localOnly=false, QWidget *parent=0L)
	~KDirSelectDialog ()
bool	localOnly () const
KUrl	startDir () const
KUrl	url () const
QAbstractItemView *	view () const
Static Public Member Functions
static KUrl	selectDirectory (const KUrl &startDir=KUrl(), bool localOnly=false, QWidget *parent=0L, const QString &caption=QString())
Protected Member Functions
virtual void	accept ()
virtual void	hideEvent (QHideEvent *event)

---

Detailed Description

A pretty dialog for a KDirSelect control for selecting directories.

Author:

Michael Jarrett <michaelj@corel.com>

See also:

KFileDialog

Definition at line 36 of file kdirselectdialog.h.

---

Constructor & Destructor Documentation

KDirSelectDialog::KDirSelectDialog	(	const KUrl &	startDir = KUrl(),
		bool	localOnly = false,
		QWidget *	parent = 0L
	)		[explicit]

Creates a new directory selection dialog.

use the static selectDirectory function

Parameters:

startDir	the directory, initially shown
localOnly	unused. You can only select paths below the startDir
parent	the parent for the dialog, usually 0L

Definition at line 269 of file kdirselectdialog.cpp.

KDirSelectDialog::~KDirSelectDialog

(

)

Destroys the directory selection dialog.

Definition at line 397 of file kdirselectdialog.cpp.

---

Member Function Documentation

void KDirSelectDialog::accept

(

)

[protected, virtual]

Definition at line 459 of file kdirselectdialog.cpp.

void KDirSelectDialog::hideEvent

(

QHideEvent *

event

)

[protected, virtual]

Reimplemented for saving the dialog geometry.

Reimplemented from KDialog.

Definition at line 476 of file kdirselectdialog.cpp.

bool KDirSelectDialog::localOnly

(

)

const

Returns whether only local directories can be selected.

Definition at line 423 of file kdirselectdialog.cpp.

KUrl KDirSelectDialog::selectDirectory	(	const KUrl &	startDir = KUrl(),
		bool	localOnly = false,
		QWidget *	parent = 0L,
		const QString &	caption = QString()
	)		[static]

Creates a KDirSelectDialog, and returns the result.

Parameters:

startDir	the directory, initially shown The tree will display this directory and subdirectories of it.
localOnly	unused. You can only select paths below the startDir
parent	the parent widget to use for the dialog, or NULL to create a parent-less dialog
caption	the caption to use for the dialog, or QString() for the default caption

Returns:

The URL selected, or an empty URL if the user canceled or no URL was selected.

NOTE: if you use this method and nothing else from libkfile, then you can use KFileDialog::getExistingDirectory (if localOnly was true) or KFileDialog::getExistingDirectoryUrl (if localOnly was false), and then you can link to libkio only instead of libkfile.

Definition at line 484 of file kdirselectdialog.cpp.

void KDirSelectDialog::setCurrentUrl

(

const KUrl &

url

)

[slot]

Sets the current url in the dialog.

Definition at line 433 of file kdirselectdialog.cpp.

KUrl KDirSelectDialog::startDir

(

)

const

Returns:

The path for the root node

Definition at line 428 of file kdirselectdialog.cpp.

KUrl KDirSelectDialog::url

(

)

const

Returns the currently selected URL, or an empty one if no item is selected.

If the URL entered in the combobox is valid and exists, it is returned. Otherwise, the URL selected in the treeview is returned instead.

Definition at line 402 of file kdirselectdialog.cpp.

QAbstractItemView * KDirSelectDialog::view

(

)

const

Returns a pointer to the view which is used for displaying the directories.

Definition at line 418 of file kdirselectdialog.cpp.

---

The documentation for this class was generated from the following files:

• kdirselectdialog.h
• kdirselectdialog.cpp