KIO
KFileDialog Class Reference
Provides a user (and developer) friendly way to select files and directories. More...
#include <kfiledialog.h>

Public Types | |
enum | OperationMode { Other = 0, Opening, Saving } |
Public Slots | |
int | exec () |
Signals | |
void | fileHighlighted (const QString &) |
void | fileSelected (const QString &) |
void | filterChanged (const QString &filter) |
void | selectionChanged () |
Public Member Functions | |
KActionCollection * | actionCollection () const |
KUrl | baseUrl () const |
KPushButton * | cancelButton () const |
void | clearFilter () |
QString | currentFilter () const |
KMimeType::Ptr | currentFilterMimeType () |
QString | currentMimeFilter () const |
KAbstractFileWidget * | fileWidget () |
KFileFilterCombo * | filterWidget () const |
bool | keepsLocation () const |
KFileDialog (const KUrl &startDir, const QString &filter, QWidget *parent, QWidget *widget=0) | |
KUrlComboBox * | locationEdit () const |
KFile::Modes | mode () const |
KPushButton * | okButton () const |
OperationMode | operationMode () const |
QString | selectedFile () const |
QStringList | selectedFiles () const |
KUrl | selectedUrl () const |
KUrl::List | selectedUrls () const |
void | setConfirmOverwrite (bool enable) |
void | setFilter (const QString &filter) |
void | setInlinePreviewShown (bool show) |
void | setKeepLocation (bool keep) |
void | setLocationLabel (const QString &text) |
void | setMimeFilter (const QStringList &types, const QString &defaultType=QString()) |
void | setMode (KFile::Modes m) |
void | setOperationMode (KFileDialog::OperationMode) |
void | setPreviewWidget (KPreviewWidgetBase *w) |
void | setSelection (const QString &name) |
void | setUrl (const KUrl &url, bool clearforward=true) |
virtual QSize | sizeHint () const |
KToolBar * | toolBar () const |
~KFileDialog () | |
Static Public Member Functions | |
static QString | getExistingDirectory (const KUrl &startDir=KUrl(), QWidget *parent=0, const QString &caption=QString()) |
static KUrl | getExistingDirectoryUrl (const KUrl &startDir=KUrl(), QWidget *parent=0, const QString &caption=QString()) |
static KUrl | getImageOpenUrl (const KUrl &startDir=KUrl(), QWidget *parent=0, const QString &caption=QString()) |
static QString | getOpenFileName (const KUrl &startDir=KUrl(), const QString &filter=QString(), QWidget *parent=0, const QString &caption=QString()) |
static QStringList | getOpenFileNames (const KUrl &startDir=KUrl(), const QString &filter=QString(), QWidget *parent=0, const QString &caption=QString()) |
static QString | getOpenFileNameWId (const KUrl &startDir, const QString &filter, WId parent_id, const QString &caption) |
static KUrl | getOpenUrl (const KUrl &startDir=KUrl(), const QString &filter=QString(), QWidget *parent=0, const QString &caption=QString()) |
static KUrl::List | getOpenUrls (const KUrl &startDir=KUrl(), const QString &filter=QString(), QWidget *parent=0, const QString &caption=QString()) |
static QString | getSaveFileName (const KUrl &startDir=KUrl(), const QString &filter=QString(), QWidget *parent=0, const QString &caption=QString()) |
static QString | getSaveFileNameWId (const KUrl &startDir, const QString &filter, WId parent_id, const QString &caption) |
static KUrl | getSaveUrl (const KUrl &startDir=KUrl(), const QString &filter=QString(), QWidget *parent=0, const QString &caption=QString()) |
static KUrl | getStartUrl (const KUrl &startDir, QString &recentDirClass) |
static void | setStartDir (const KUrl &directory) |
Protected Slots | |
virtual void | accept () |
virtual void | slotCancel () |
virtual void | slotOk () |
Protected Member Functions | |
virtual void | hideEvent (QHideEvent *event) |
virtual void | keyPressEvent (QKeyEvent *e) |
Detailed Description
Provides a user (and developer) friendly way to select files and directories.The widget can be used as a drop in replacement for the QFileDialog widget, but has greater functionality and a nicer GUI.
You will usually want to use one of the static methods getOpenFileName(), getSaveFileName(), getOpenUrl() or for multiple files getOpenFileNames() or getOpenUrls().
The dialog has been designed to allow applications to customize it by subclassing. It uses geometry management to ensure that subclasses can easily add children that will be incorporated into the layout.

KDE File Dialog
Definition at line 67 of file kfiledialog.h.
Member Enumeration Documentation
Defines some default behavior of the filedialog.
E.g. in mode Opening
and Saving
, the selected files/urls will be added to the "recent documents" list. The Saving mode also implies setKeepLocation() being set.
Other
means that no default actions are performed.
- See also:
- setOperationMode
Definition at line 84 of file kfiledialog.h.
Constructor & Destructor Documentation
KFileDialog::KFileDialog | ( | const KUrl & | startDir, | |
const QString & | filter, | |||
QWidget * | parent, | |||
QWidget * | widget = 0 | |||
) |
Constructs a file dialog.
- Parameters:
-
startDir This can either be - The URL of the directory to start in.
- A KUrl() to start in the current working directory, or the last directory where a file has been selected.
- An URL starting with 'kfiledialog:///<keyword>' to start in the directory last used by a filedialog in the same application that specified the same keyword.
- An URL starting with 'kfiledialog:///<keyword>?global' to start in the directory last used by a filedialog in any application that specified the same keyword.
filter A shell glob or a mime-type-filter that specifies which files to display. See setFilter() and setMimeFilter() for details on how to use this argument. parent The parent widget of this dialog widget A widget, or a widget of widgets, for displaying custom data in the dialog. This can be used, for example, to display a check box with the caption "Open as read-only". When creating this widget, you don't need to specify a parent, since the widget's parent will be set automatically by KFileDialog.
Definition at line 227 of file kfiledialog.cpp.
KFileDialog::~KFileDialog | ( | ) |
Member Function Documentation
void KFileDialog::accept | ( | ) | [protected, virtual, slot] |
Definition at line 378 of file kfiledialog.cpp.
KActionCollection * KFileDialog::actionCollection | ( | ) | const |
- Returns:
- a pointer to the action collection, holding all the used KActions.
Definition at line 767 of file kfiledialog.cpp.
KUrl KFileDialog::baseUrl | ( | ) | const |
KPushButton * KFileDialog::cancelButton | ( | ) | const |
- Returns:
- a pointer to the Cancel-Button in the filedialog. You may use it e.g. to set a custom text to it.
Definition at line 752 of file kfiledialog.cpp.
void KFileDialog::clearFilter | ( | ) |
Clears any mime- or namefilter.
Does not reload the directory.
Definition at line 330 of file kfiledialog.cpp.
QString KFileDialog::currentFilter | ( | ) | const |
Returns the current filter as entered by the user or one of the predefined set via setFilter().
- See also:
- setFilter()
Definition at line 314 of file kfiledialog.cpp.
KMimeType::Ptr KFileDialog::currentFilterMimeType | ( | ) |
Returns the mimetype for the desired output format.
This is only valid if setMimeFilter() has been called previously.
- See also:
- setFilterMimeType()
Definition at line 344 of file kfiledialog.cpp.
QString KFileDialog::currentMimeFilter | ( | ) | const |
The mimetype for the desired output format.
This is only valid if setMimeFilter() has been called previously.
- See also:
- setMimeFilter()
Definition at line 339 of file kfiledialog.cpp.
int KFileDialog::exec | ( | ) | [slot] |
Definition at line 850 of file kfiledialog.cpp.
void KFileDialog::fileHighlighted | ( | const QString & | ) | [signal] |
Emitted when the user highlights a file.
void KFileDialog::fileSelected | ( | const QString & | ) | [signal] |
Emitted when the user selects a file.
It is only emitted in single- selection mode. The best way to get notified about selected file(s) is to connect to the okClicked() signal inherited from KDialog and call selectedFile(), selectedFiles(), selectedUrl() or selectedUrls().
KAbstractFileWidget * KFileDialog::fileWidget | ( | ) |
Returns the KFileWidget that implements most of this file dialog.
If you link to libkfile you can cast this to a KFileWidget*.
Definition at line 844 of file kfiledialog.cpp.
void KFileDialog::filterChanged | ( | const QString & | filter | ) | [signal] |
Emitted when the filter changed, i.e.
the user entered an own filter or chose one of the predefined set via setFilter().
- Parameters:
-
filter contains the new filter (only the extension part, not the explanation), i.e. "*.cpp" or "*.cpp *.cc".
- See also:
- setFilter()
KFileFilterCombo * KFileDialog::filterWidget | ( | ) | const |
- Returns:
- the combobox that contains the filters You need to link to libkfile to use this widget.
Definition at line 762 of file kfiledialog.cpp.
QString KFileDialog::getExistingDirectory | ( | const KUrl & | startDir = KUrl() , |
|
QWidget * | parent = 0 , |
|||
const QString & | caption = QString() | |||
) | [static] |
Creates a modal directory-selection dialog and returns the selected directory (local only) or an empty string if none was chosen.
- Parameters:
-
startDir This can either be - The URL of the directory to start in.
- A KUrl() to start in the current working directory, or the last directory where a file has been selected.
- An URL starting with 'kfiledialog:///<keyword>' to start in the directory last used by a filedialog in the same application that specified the same keyword.
- An URL starting with 'kfiledialog:///<keyword>?global' to start in the directory last used by a filedialog in any application that specified the same keyword.
parent The widget the dialog will be centered on initially. caption The name of the dialog widget.
- Returns:
- the path to an existing local directory.
Definition at line 548 of file kfiledialog.cpp.
KUrl KFileDialog::getExistingDirectoryUrl | ( | const KUrl & | startDir = KUrl() , |
|
QWidget * | parent = 0 , |
|||
const QString & | caption = QString() | |||
) | [static] |
Creates a modal directory-selection dialog and returns the selected directory or an empty string if none was chosen.
This version supports remote urls.
- Parameters:
-
startDir This can either be - The URL of the directory to start in.
- A KUrl() to start in the current working directory, or the last directory where a file has been selected.
- An URL starting with 'kfiledialog:///<keyword>' to start in the directory last used by a filedialog in the same application that specified the same keyword.
- An URL starting with 'kfiledialog:///<keyword>?global' to start in the directory last used by a filedialog in any application that specified the same keyword.
parent The widget the dialog will be centered on initially. caption The name of the dialog widget.
- Returns:
- the url to an existing directory (local or remote).
Definition at line 535 of file kfiledialog.cpp.
KUrl KFileDialog::getImageOpenUrl | ( | const KUrl & | startDir = KUrl() , |
|
QWidget * | parent = 0 , |
|||
const QString & | caption = QString() | |||
) | [static] |
Creates a modal file dialog with an image previewer and returns the selected url or an empty string if none was chosen.
- Parameters:
-
startDir This can either be - The URL of the directory to start in.
- A KUrl() to start in the current working directory, or the last directory where a file has been selected.
- An URL starting with 'kfiledialog:///<keyword>' to start in the directory last used by a filedialog in the same application that specified the same keyword.
- An URL starting with 'kfiledialog:///<keyword>?global' to start in the directory last used by a filedialog in any application that specified the same keyword.
parent The widget the dialog will be centered on initially. caption The name of the dialog widget.
Definition at line 563 of file kfiledialog.cpp.
QString KFileDialog::getOpenFileName | ( | const KUrl & | startDir = KUrl() , |
|
const QString & | filter = QString() , |
|||
QWidget * | parent = 0 , |
|||
const QString & | caption = QString() | |||
) | [static] |
Creates a modal file dialog and return the selected filename or an empty string if none was chosen.
Note that with this method the user must select an existing filename.
- Parameters:
-
startDir This can either be - The URL of the directory to start in.
- A KUrl() to start in the current working directory, or the last directory where a file has been selected.
- An URL starting with 'kfiledialog:///<keyword>' to start in the directory last used by a filedialog in the same application that specified the same keyword.
- An URL starting with 'kfiledialog:///<keyword>?global' to start in the directory last used by a filedialog in any application that specified the same keyword.
filter A shell glob or a mime-type-filter that specifies which files to display. The preferred option is to set a list of mimetype names, see setMimeFilter() for details. Otherwise you can set the text to be displayed for the each glob, and provide multiple globs, see setFilter() for details. parent The widget the dialog will be centered on initially. caption The name of the dialog widget.
Definition at line 418 of file kfiledialog.cpp.
QStringList KFileDialog::getOpenFileNames | ( | const KUrl & | startDir = KUrl() , |
|
const QString & | filter = QString() , |
|||
QWidget * | parent = 0 , |
|||
const QString & | caption = QString() | |||
) | [static] |
Creates a modal file dialog and returns the selected filenames or an empty list if none was chosen.
Note that with this method the user must select an existing filename.
- Parameters:
-
startDir This can either be - The URL of the directory to start in.
- A KUrl() to start in the current working directory, or the last directory where a file has been selected.
- An URL starting with 'kfiledialog:///<keyword>' to start in the directory last used by a filedialog in the same application that specified the same keyword.
- An URL starting with 'kfiledialog:///<keyword>?global' to start in the directory last used by a filedialog in any application that specified the same keyword.
filter A shell glob or a mime-type-filter that specifies which files to display. The preferred option is to set a list of mimetype names, see setMimeFilter() for details. Otherwise you can set the text to be displayed for the each glob, and provide multiple globs, see setFilter() for details. parent The widget the dialog will be centered on initially. caption The name of the dialog widget.
Definition at line 464 of file kfiledialog.cpp.
QString KFileDialog::getOpenFileNameWId | ( | const KUrl & | startDir, | |
const QString & | filter, | |||
WId | parent_id, | |||
const QString & | caption | |||
) | [static] |
Use this version only if you have no QWidget available as parent widget.
This can be the case if the parent widget is a widget in another process or if the parent widget is a non-Qt widget. For example, in a GTK program.
Definition at line 442 of file kfiledialog.cpp.
KUrl KFileDialog::getOpenUrl | ( | const KUrl & | startDir = KUrl() , |
|
const QString & | filter = QString() , |
|||
QWidget * | parent = 0 , |
|||
const QString & | caption = QString() | |||
) | [static] |
Creates a modal file dialog and returns the selected URL or an empty string if none was chosen.
Note that with this method the user must select an existing URL.
- Parameters:
-
startDir This can either be - The URL of the directory to start in.
- A KUrl() to start in the current working directory, or the last directory where a file has been selected.
- An URL starting with 'kfiledialog:///<keyword>' to start in the directory last used by a filedialog in the same application that specified the same keyword.
- An URL starting with 'kfiledialog:///<keyword>?global' to start in the directory last used by a filedialog in any application that specified the same keyword.
filter A shell glob or a mime-type-filter that specifies which files to display. The preferred option is to set a list of mimetype names, see setMimeFilter() for details. Otherwise you can set the text to be displayed for the each glob, and provide multiple globs, see setFilter() for details. parent The widget the dialog will be centered on initially. caption The name of the dialog widget.
Definition at line 488 of file kfiledialog.cpp.
KUrl::List KFileDialog::getOpenUrls | ( | const KUrl & | startDir = KUrl() , |
|
const QString & | filter = QString() , |
|||
QWidget * | parent = 0 , |
|||
const QString & | caption = QString() | |||
) | [static] |
Creates a modal file dialog and returns the selected URLs or an empty list if none was chosen.
Note that with this method the user must select an existing filename.
- Parameters:
-
startDir This can either be - The URL of the directory to start in.
- A KUrl() to start in the current working directory, or the last directory where a file has been selected.
- An URL starting with 'kfiledialog:///<keyword>' to start in the directory last used by a filedialog in the same application that specified the same keyword.
- An URL starting with 'kfiledialog:///<keyword>?global' to start in the directory last used by a filedialog in any application that specified the same keyword.
filter A shell glob or a mime-type-filter that specifies which files to display. The preferred option is to set a list of mimetype names, see setMimeFilter() for details. Otherwise you can set the text to be displayed for the each glob, and provide multiple globs, see setFilter() for details. parent The widget the dialog will be centered on initially. caption The name of the dialog widget.
Definition at line 507 of file kfiledialog.cpp.
QString KFileDialog::getSaveFileName | ( | const KUrl & | startDir = KUrl() , |
|
const QString & | filter = QString() , |
|||
QWidget * | parent = 0 , |
|||
const QString & | caption = QString() | |||
) | [static] |
Creates a modal file dialog and returns the selected filename or an empty string if none was chosen.
Note that with this method the user need not select an existing filename.
- Parameters:
-
startDir This can either be - The URL of the directory to start in.
- A KUrl() to start in the current working directory, or the last directory where a file has been selected.
- An URL starting with 'kfiledialog:///<keyword>' to start in the directory last used by a filedialog in the same application that specified the same keyword.
- An URL starting with 'kfiledialog:///<keyword>?global' to start in the directory last used by a filedialog in any application that specified the same keyword.
filter A shell glob or a mime-type-filter that specifies which files to display. The preferred option is to set a list of mimetype names, see setMimeFilter() for details. Otherwise you can set the text to be displayed for the each glob, and provide multiple globs, see setFilter() for details. parent The widget the dialog will be centered on initially. caption The name of the dialog widget.
Definition at line 619 of file kfiledialog.cpp.
QString KFileDialog::getSaveFileNameWId | ( | const KUrl & | startDir, | |
const QString & | filter, | |||
WId | parent_id, | |||
const QString & | caption | |||
) | [static] |
This function accepts the window id of the parent window, instead of QWidget*.
It should be used only when necessary.
Definition at line 672 of file kfiledialog.cpp.
KUrl KFileDialog::getSaveUrl | ( | const KUrl & | startDir = KUrl() , |
|
const QString & | filter = QString() , |
|||
QWidget * | parent = 0 , |
|||
const QString & | caption = QString() | |||
) | [static] |
Creates a modal file dialog and returns the selected filename or an empty string if none was chosen.
Note that with this method the user need not select an existing filename.
- Parameters:
-
startDir This can either be - The URL of the directory to start in.
- A KUrl() to start in the current working directory, or the last directory where a file has been selected.
- An URL starting with 'kfiledialog:///<keyword>' to start in the directory last used by a filedialog in the same application that specified the same keyword.
- An URL starting with 'kfiledialog:///<keyword>?global' to start in the directory last used by a filedialog in any application that specified the same keyword.
filter A shell glob or a mime-type-filter that specifies which files to display. The preferred option is to set a list of mimetype names, see setMimeFilter() for details. Otherwise you can set the text to be displayed for the each glob, and provide multiple globs, see setFilter() for details. parent The widget the dialog will be centered on initially. caption The name of the dialog widget.
Definition at line 705 of file kfiledialog.cpp.
KUrl KFileDialog::getStartUrl | ( | const KUrl & | startDir, | |
QString & | recentDirClass | |||
) | [static] |
This method implements the logic to determine the user's default directory to be listed.
E.g. the documents directory, home directory or a recently used directory.
- Parameters:
-
startDir A url, to be used. May use the 'kfiledialog:///keyword' and 'kfiledialog:///keyword?global' syntax as documented in the KFileDialog() constructor. recentDirClass If the 'kfiledialog:///' syntax is used, recentDirClass will contain the string to be used later for KRecentDir::dir()
- Returns:
- The URL that should be listed by default (e.g. by KFileDialog or KDirSelectDialog).
Definition at line 826 of file kfiledialog.cpp.
void KFileDialog::hideEvent | ( | QHideEvent * | event | ) | [protected, virtual] |
bool KFileDialog::keepsLocation | ( | ) | const |
- Returns:
- whether the contents of the location edit are kept when changing directories.
Definition at line 779 of file kfiledialog.cpp.
void KFileDialog::keyPressEvent | ( | QKeyEvent * | e | ) | [protected, virtual] |
KUrlComboBox * KFileDialog::locationEdit | ( | ) | const |
- Returns:
- the combobox used to type the filename or full location of the file. You need to link to libkfile to use this widget.
Definition at line 757 of file kfiledialog.cpp.
KFile::Modes KFileDialog::mode | ( | ) | const |
Returns the mode of the filedialog.
- See also:
- setMode()
Definition at line 740 of file kfiledialog.cpp.
KPushButton * KFileDialog::okButton | ( | ) | const |
- Returns:
- a pointer to the OK-Button in the filedialog. You may use it e.g. to set a custom text to it.
Definition at line 747 of file kfiledialog.cpp.
KFileDialog::OperationMode KFileDialog::operationMode | ( | ) | const |
- Returns:
- the current operation mode, Opening, Saving or Other. Default is Other.
- See also:
- operationMode
Definition at line 794 of file kfiledialog.cpp.
QString KFileDialog::selectedFile | ( | ) | const |
Returns the full path of the selected file in the local filesystem.
(Local files only)
Definition at line 598 of file kfiledialog.cpp.
QStringList KFileDialog::selectedFiles | ( | ) | const |
KUrl KFileDialog::selectedUrl | ( | ) | const |
KUrl::List KFileDialog::selectedUrls | ( | ) | const |
void KFileDialog::selectionChanged | ( | ) | [signal] |
Emitted when the user hilights one or more files in multiselection mode.
Note: fileHighlighted() or fileSelected() are not emitted in multiselection mode. You may use selectedItems() to ask for the current highlighted items.
- See also:
- fileSelected
void KFileDialog::setConfirmOverwrite | ( | bool | enable | ) |
Sets whether the dialog should ask before accepting the selected file when KFileDialog::OperationMode is set to Saving.
In this case a KMessageBox appears for confirmation.
- Parameters:
-
enable Set this to true to enable checking.
- Since:
- 4.2
Definition at line 528 of file kfiledialog.cpp.
void KFileDialog::setFilter | ( | const QString & | filter | ) |
Sets the filter to be used to filter
.
You can set more filters for the user to select separated by '\n'
. Every filter entry is defined through namefilter|text
to display. If no '|'
is found in the expression, just the namefilter is shown. Examples:
kfile->setFilter("*.cpp|C++ Source Files\n*.h|Header files"); kfile->setFilter("*.cpp"); kfile->setFilter("*.cpp|Sources (*.cpp)"); kfile->setFilter("*.cpp|" + i18n("Sources (*.cpp)")); kfile->setFilter("*.cpp *.cc *.C|C++ Source Files\n*.h *.H|Header files");
Note: The text to display is not parsed in any way. So, if you want to show the suffix to select by a specific filter, you must repeat it.
If the filter contains an unescaped '/'
, a mimetype-filter is assumed. If you would like a '/' visible in your filter it can be escaped with a '\'
. You can specify multiple mimetypes like this (separated with space):
kfile->setFilter( "image/png text/html text/plain" ); kfile->setFilter( "*.cue|CUE\\/BIN Files (*.cue)" );
- See also:
- filterChanged
Definition at line 305 of file kfiledialog.cpp.
void KFileDialog::setInlinePreviewShown | ( | bool | show | ) |
Forces the inline previews to be shown or hidden, depending on show
.
- Parameters:
-
show Whether to show inline previews or not.
- Since:
- 4.2
Definition at line 356 of file kfiledialog.cpp.
void KFileDialog::setKeepLocation | ( | bool | keep | ) |
Sets whether the filename/url should be kept when changing directories.
This is for example useful when having a predefined filename where the full path for that file is searched.
This is implicitly set when operationMode() is KFileDialog::Saving
getSaveFileName() and getSaveUrl() set this to true by default, so that you can type in the filename and change the directory without having to type the name again.
Definition at line 772 of file kfiledialog.cpp.
void KFileDialog::setLocationLabel | ( | const QString & | text | ) |
Sets the text to be displayed in front of the selection.
The default is "Location". Most useful if you want to make clear what the location is used for.
Definition at line 298 of file kfiledialog.cpp.
void KFileDialog::setMimeFilter | ( | const QStringList & | types, | |
const QString & | defaultType = QString() | |||
) |
Sets the filter up to specify the output type.
- Parameters:
-
types a list of mimetypes that can be used as output format defaultType the default mimetype to use as output format, if any. If defaultType
is set, it will be set as the current item. Otherwise, a first item showing all the mimetypes will be created. Typically,defaultType
should be empty for loading and set for saving.
Definition at line 321 of file kfiledialog.cpp.
void KFileDialog::setMode | ( | KFile::Modes | m | ) |
Sets the mode of the dialog.
The mode is defined as (in kfile.h):
enum Mode { File = 1, Directory = 2, Files = 4, ExistingOnly = 8, LocalOnly = 16 };
KFile::Modes mode = KFile::Files | KFile::ExistingOnly | KFile::LocalOnly ); setMode( mode );
Definition at line 732 of file kfiledialog.cpp.
void KFileDialog::setOperationMode | ( | KFileDialog::OperationMode | mode | ) |
Sets the operational mode of the filedialog to Saving
, Opening
or Other
.
This will set some flags that are specific to loading or saving files. E.g. setKeepLocation() makes mostly sense for a save-as dialog. So setOperationMode( KFileDialog::Saving ); sets setKeepLocation for example.
The mode Saving
, together with a default filter set via setMimeFilter() will make the filter combobox read-only.
The default mode is Opening
.
Call this method right after instantiating KFileDialog.
- See also:
- operationMode
Definition at line 786 of file kfiledialog.cpp.
void KFileDialog::setPreviewWidget | ( | KPreviewWidgetBase * | w | ) |
Adds a preview widget and enters the preview mode.
In this mode the dialog is split and the right part contains your preview widget.
Ownership is transferred to KFileDialog. You need to create the preview-widget with "new", i.e. on the heap.
- Parameters:
-
w The widget to be used for the preview.
Definition at line 349 of file kfiledialog.cpp.
void KFileDialog::setSelection | ( | const QString & | name | ) |
Sets the file name to preselect to name
.
This takes absolute URLs and relative file names.
Definition at line 408 of file kfiledialog.cpp.
void KFileDialog::setStartDir | ( | const KUrl & | directory | ) | [static] |
For internal use only.
Used by KDirSelectDialog to share the dialog's start directory.
Definition at line 832 of file kfiledialog.cpp.
void KFileDialog::setUrl | ( | const KUrl & | url, | |
bool | clearforward = true | |||
) |
Sets the directory to view.
- Parameters:
-
url URL to show. clearforward Indicates whether the forward queue should be cleared.
Definition at line 398 of file kfiledialog.cpp.
QSize KFileDialog::sizeHint | ( | ) | const [virtual] |
void KFileDialog::slotCancel | ( | ) | [protected, virtual, slot] |
Definition at line 390 of file kfiledialog.cpp.
void KFileDialog::slotOk | ( | ) | [protected, virtual, slot] |
Definition at line 370 of file kfiledialog.cpp.
KToolBar * KFileDialog::toolBar | ( | ) | const |
Returns a pointer to the toolbar.
You can use this to insert custom items into it, e.g.:
yourAction = new KAction( i18n("Your Action"), 0, this, SLOT( yourSlot() ), this, "action name" ); yourAction->plug( kfileDialog->toolBar() );
Definition at line 839 of file kfiledialog.cpp.
The documentation for this class was generated from the following files: