KDE 4.5 PyKDE API Reference
KDirSelectDialog Class Reference
from PyKDE4.kio import *
Inherits: KDialog → QDialog → QWidget → QObject
Detailed Description
A pretty dialog for a KDirSelect control for selecting directories.
- See also:
- KFileDialog
Methods | |
| __init__ (self, KUrl startDir=KUrl(), bool localOnly=0, QWidget parent=0) | |
| accept (self) | |
| hideEvent (self, QHideEvent event) | |
| bool | localOnly (self) |
| setCurrentUrl (self, KUrl url) | |
| KUrl | startDir (self) |
| KUrl | url (self) |
| QAbstractItemView | view (self) |
Static Methods | |
| KUrl | selectDirectory (KUrl startDir=KUrl(), bool localOnly=0, QWidget parent=0, QString caption=QString()) |
Method Documentation
Creates a new directory selection dialog.
- Internal:
- 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
| accept | ( | self ) |
| hideEvent | ( | self, | ||
| QHideEvent | event | |||
| ) |
Reimplemented for saving the dialog geometry.
| bool localOnly | ( | self ) |
Returns whether only local directories can be selected.
| setCurrentUrl | ( | self, | ||
| KUrl | url | |||
| ) |
Sets the current url in the dialog.
| KUrl startDir | ( | self ) |
- Returns:
- The path for the root node
| KUrl url | ( | self ) |
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.
| QAbstractItemView view | ( | self ) |
Returns a pointer to the view which is used for displaying the directories.
Static Method Documentation
| KUrl selectDirectory | ( | KUrl | startDir=KUrl(), | |
| bool | localOnly=0, | |||
| QWidget | parent=0, | |||
| QString | caption=QString() | |||
| ) |
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.
