.TH "KDirOperator" 3 "28 Jan 2004" "kio Library" \" -*- nroff -*-
.ad l
.nh
.SH NAME
KDirOperator \- This widget works as a network transparent filebrowser. A widget for displaying files and browsing directories.  

.PP
.SH SYNOPSIS
.br
.PP
\fC#include <kdiroperator.h>\fP
.PP
Inherits \fBQWidget\fP.
.PP
.SS "Public Types"

.in +1c
.ti -1c
.RI "enum \fBActionTypes\fP { \fBSortActions\fP =  1, \fBViewActions\fP =  2, \fBNavActions\fP =  4, \fBFileActions\fP =  8, \fBAllActions\fP =  15 }"
.br
.RI "\fIThe various action types. \fP"
.in -1c
.SS "Public Slots"

.in +1c
.ti -1c
.RI "void \fBback\fP ()"
.br
.RI "\fIGoes one step back in the history and opens that url. \fP"
.ti -1c
.RI "void \fBforward\fP ()"
.br
.RI "\fIGoes one step forward in the history and opens that url. \fP"
.ti -1c
.RI "void \fBhome\fP ()"
.br
.RI "\fIEnters the home directory. \fP"
.ti -1c
.RI "void \fBcdUp\fP ()"
.br
.RI "\fIGoes one directory up from the current url. \fP"
.ti -1c
.RI "void \fBupdateDir\fP ()"
.br
.RI "\fIto update the view after changing the settings \fP"
.ti -1c
.RI "void \fBrereadDir\fP ()"
.br
.RI "\fIRe-reads the current url. \fP"
.ti -1c
.RI "void \fBmkdir\fP ()"
.br
.RI "\fIOpens a dialog to create a new directory. \fP"
.ti -1c
.RI "void \fBdeleteSelected\fP ()"
.br
.RI "\fIDeletes the currently selected files/directories. \fP"
.ti -1c
.RI "void \fBupdateSelectionDependentActions\fP ()"
.br
.RI "\fIEnables/disables actions that are selection dependent. \fP"
.ti -1c
.RI "\fBQString\fP \fBmakeCompletion\fP (const  \fBQString\fP &)"
.br
.RI "\fITries to complete the given string (only completes files). \fP"
.ti -1c
.RI "\fBQString\fP \fBmakeDirCompletion\fP (const  \fBQString\fP &)"
.br
.RI "\fITries to complete the given string (only completes directores). \fP"
.in -1c
.SS "Signals"

.in +1c
.ti -1c
.RI "void \fBurlEntered\fP (const  \fBKURL\fP &)"
.br
.ti -1c
.RI "void \fBupdateInformation\fP (int files, int dirs)"
.br
.ti -1c
.RI "void \fBcompletion\fP (const  \fBQString\fP &)"
.br
.ti -1c
.RI "void \fBfinishedLoading\fP ()"
.br
.ti -1c
.RI "void \fBviewChanged\fP (\fBKFileView\fP *newView)"
.br
.RI "\fIEmitted whenever the current fileview is changed, either by an explicit call to \fBsetView\fP() or by the user selecting a different view thru the GUI. \fP"
.ti -1c
.RI "void \fBfileHighlighted\fP (const  \fBKFileItem\fP *item)"
.br
.RI "\fIEmitted when a file is highlighted or generally the selection changes in multiselection mode. \fP"
.ti -1c
.RI "void \fBdirActivated\fP (const  \fBKFileItem\fP *item)"
.br
.ti -1c
.RI "void \fBfileSelected\fP (const  \fBKFileItem\fP *item)"
.br
.in -1c
.SS "Public Member Functions"

.in +1c
.ti -1c
.RI "\fBKDirOperator\fP (const  \fBKURL\fP &urlName=\fBKURL\fP(), \fBQWidget\fP *parent=0, const  char *name=0)"
.br
.RI "\fIConstructs the KDirOperator with no initial view. \fP"
.ti -1c
.RI "virtual \fB~KDirOperator\fP ()"
.br
.RI "\fIDestroys the KDirOperator. \fP"
.ti -1c
.RI "void \fBsetShowHiddenFiles\fP (bool s)"
.br
.RI "\fIEnables/disables showing hidden files. \fP"
.ti -1c
.RI "bool \fBshowHiddenFiles\fP () const "
.br
.ti -1c
.RI "void \fBclose\fP ()"
.br
.RI "\fIStops loading immediately. \fP"
.ti -1c
.RI "void \fBsetNameFilter\fP (const  \fBQString\fP &filter)"
.br
.RI "\fISets a filter like '*.cpp *.h *.o'. \fP"
.ti -1c
.RI "const  \fBQString\fP & \fBnameFilter\fP () const "
.br
.ti -1c
.RI "void \fBsetMimeFilter\fP (const  \fBQStringList\fP &mimetypes)"
.br
.RI "\fISets a list of mimetypes as filter. \fP"
.ti -1c
.RI "\fBQStringList\fP \fBmimeFilter\fP () const "
.br
.ti -1c
.RI "void \fBclearFilter\fP ()"
.br
.RI "\fIClears both the namefilter and mimetype filter, so that all files and directories will be shown. \fP"
.ti -1c
.RI "\fBKURL\fP \fBurl\fP () const "
.br
.ti -1c
.RI "void \fBsetURL\fP (const  \fBKURL\fP &url, bool clearforward)"
.br
.RI "\fISets a new url to list. \fP"
.ti -1c
.RI "void \fBsetCurrentItem\fP (const  \fBQString\fP &filename)"
.br
.RI "\fIClears the current selection and attempts to set \fCfilename\fP the current file. \fP"
.ti -1c
.RI "void \fBsetView\fP (\fBKFileView\fP *view)"
.br
.RI "\fISets a new \fBKFileView\fP to be used for showing and browsing files. \fP"
.ti -1c
.RI "\fBKFileView\fP * \fBview\fP () const "
.br
.ti -1c
.RI "\fBQWidget\fP * \fBviewWidget\fP () const "
.br
.RI "\fIReturns the widget of the current view. \fP"
.ti -1c
.RI "void \fBsetView\fP (KFile::FileView view)"
.br
.RI "\fISets one of the predefined fileviews. \fP"
.ti -1c
.RI "void \fBsetSorting\fP (QDir::SortSpec)"
.br
.RI "\fISets the way to sort files and directories. \fP"
.ti -1c
.RI "QDir::SortSpec \fBsorting\fP () const "
.br
.ti -1c
.RI "bool \fBisRoot\fP () const "
.br
.ti -1c
.RI "\fBKDirLister\fP * \fBdirLister\fP () const "
.br
.ti -1c
.RI "\fBKProgress\fP * \fBprogressBar\fP () const "
.br
.ti -1c
.RI "void \fBsetMode\fP (\fBKFile::Mode\fP m)"
.br
.RI "\fISets the listing/selection mode for the views, an OR'ed combination of 
.IP "\(bu" 2
File 
.IP "\(bu" 2
Directory 
.IP "\(bu" 2
Files 
.IP "\(bu" 2
ExistingOnly 
.IP "\(bu" 2
LocalOnly. 
.PP
\fP"
.ti -1c
.RI "\fBKFile::Mode\fP \fBmode\fP () const "
.br
.ti -1c
.RI "void \fBsetPreviewWidget\fP (const  \fBQWidget\fP *w)"
.br
.RI "\fISets a preview-widget to be shown next to the file-view. \fP"
.ti -1c
.RI "const  \fBKFileItemList\fP * \fBselectedItems\fP () const "
.br
.ti -1c
.RI "bool \fBisSelected\fP (const  \fBKFileItem\fP *item) const "
.br
.ti -1c
.RI "int \fBnumDirs\fP () const "
.br
.ti -1c
.RI "int \fBnumFiles\fP () const "
.br
.ti -1c
.RI "\fBKCompletion\fP * \fBcompletionObject\fP () const "
.br
.ti -1c
.RI "\fBKCompletion\fP * \fBdirCompletionObject\fP () const "
.br
.ti -1c
.RI "\fBKActionCollection\fP * \fBactionCollection\fP () const "
.br
.RI "\fIan accessor to a collection of all available Actions. \fP"
.ti -1c
.RI "void \fBsetViewConfig\fP (\fBKConfig\fP *config, const  \fBQString\fP &group)"
.br
.RI "\fISets the config object and the to be used group in KDirOperator. \fP"
.ti -1c
.RI "\fBKConfig\fP * \fBviewConfig\fP ()"
.br
.RI "\fIReturns the \fBKConfig\fP object used for saving and restoring view's configuration. \fP"
.ti -1c
.RI "\fBQString\fP \fBviewConfigGroup\fP () const "
.br
.RI "\fIReturns the group name used for saving and restoring view's configuration. \fP"
.ti -1c
.RI "virtual void \fBreadConfig\fP (\fBKConfig\fP *, const  \fBQString\fP &group=QString::null)"
.br
.RI "\fIReads the default settings for a view, i.e. \fP"
.ti -1c
.RI "virtual void \fBwriteConfig\fP (\fBKConfig\fP *, const  \fBQString\fP &group=QString::null)"
.br
.RI "\fISaves the current settings like sorting, simple or detailed view. \fP"
.ti -1c
.RI "void \fBsetOnlyDoubleClickSelectsFiles\fP (bool enable)"
.br
.RI "\fIThis is a \fBKFileDialog\fP specific hack: we want to select directories with single click, but not files. \fP"
.ti -1c
.RI "bool \fBonlyDoubleClickSelectsFiles\fP () const "
.br
.ti -1c
.RI "bool \fBmkdir\fP (const  \fBQString\fP &directory, bool enterDirectory=true)"
.br
.RI "\fICreates the given directory/url. \fP"
.ti -1c
.RI "\fBKIO::DeleteJob\fP * \fBdel\fP (const  \fBKFileItemList\fP &items, bool ask=true, bool showProgress=true)"
.br
.RI "\fIStarts and returns a \fBKIO::DeleteJob\fP to delete the given \fCitems\fP. \fP"
.ti -1c
.RI "\fBKIO::DeleteJob\fP * \fBdel\fP (const  \fBKFileItemList\fP &items, \fBQWidget\fP *parent, bool ask=true, bool showProgress=true)"
.br
.RI "\fIStarts and returns a \fBKIO::DeleteJob\fP to delete the given \fCitems\fP. \fP"
.ti -1c
.RI "void \fBclearHistory\fP ()"
.br
.RI "\fIClears the forward and backward history. \fP"
.ti -1c
.RI "void \fBsetEnableDirHighlighting\fP (bool enable)"
.br
.RI "\fIWhen going up in the directory hierarchy, KDirOperator can highlight the directory that was just left. \fP"
.ti -1c
.RI "bool \fBdirHighlighting\fP () const "
.br
.ti -1c
.RI "bool \fBdirOnlyMode\fP () const "
.br
.ti -1c
.RI "void \fBsetupMenu\fP (int whichActions)"
.br
.RI "\fISets up the action menu. \fP"
.in -1c
.SS "Static Public Member Functions"

.in +1c
.ti -1c
.RI "bool \fBdirOnlyMode\fP (uint mode)"
.br
.in -1c
.SS "Protected Slots"

.in +1c
.ti -1c
.RI "void \fBresetCursor\fP ()"
.br
.RI "\fIRestores the normal cursor after showing the busy-cursor. \fP"
.ti -1c
.RI "void \fBpathChanged\fP ()"
.br
.RI "\fICalled after \fBsetURL\fP() to load the directory, update the history, etc. \fP"
.ti -1c
.RI "void \fBinsertNewFiles\fP (const  \fBKFileItemList\fP &newone)"
.br
.RI "\fIAdds a new list of KFileItems to the view (coming from \fBKDirLister\fP). \fP"
.ti -1c
.RI "void \fBitemDeleted\fP (\fBKFileItem\fP *)"
.br
.RI "\fIRemoves the given \fBKFileItem\fP item from the view (usually called from \fBKDirLister\fP). \fP"
.ti -1c
.RI "void \fBselectDir\fP (const  \fBKFileItem\fP *item)"
.br
.RI "\fIEnters the directory specified by the given \fCitem\fP. \fP"
.ti -1c
.RI "void \fBselectFile\fP (const  \fBKFileItem\fP *item)"
.br
.RI "\fIEmits fileSelected( item ). \fP"
.ti -1c
.RI "void \fBhighlightFile\fP (const  \fBKFileItem\fP *i)"
.br
.RI "\fIEmits fileHighlighted( i ). \fP"
.ti -1c
.RI "virtual void \fBactivatedMenu\fP (const  \fBKFileItem\fP *, const  \fBQPoint\fP &\fBpos\fP)"
.br
.RI "\fICalled upon right-click to activate the popupmenu. \fP"
.ti -1c
.RI "void \fBsortByName\fP ()"
.br
.RI "\fIChanges sorting to sort by name. \fP"
.ti -1c
.RI "void \fBsortBySize\fP ()"
.br
.RI "\fIChanges sorting to sort by size. \fP"
.ti -1c
.RI "void \fBsortByDate\fP ()"
.br
.RI "\fIChanges sorting to sort by date. \fP"
.ti -1c
.RI "void \fBsortReversed\fP ()"
.br
.RI "\fIChanges sorting to reverse sorting. \fP"
.ti -1c
.RI "void \fBtoggleDirsFirst\fP ()"
.br
.RI "\fIToggles showing directories first / having them sorted like files. \fP"
.ti -1c
.RI "void \fBtoggleIgnoreCase\fP ()"
.br
.RI "\fIToggles case sensitive / case insensitive sorting. \fP"
.ti -1c
.RI "void \fBslotCompletionMatch\fP (const  \fBQString\fP &match)"
.br
.RI "\fITries to make the given \fCmatch\fP as current item in the view and emits completion( match ). \fP"
.in -1c
.SS "Protected Member Functions"

.in +1c
.ti -1c
.RI "virtual \fBKFileView\fP * \fBcreateView\fP (\fBQWidget\fP *parent, KFile::FileView view)"
.br
.RI "\fIA view factory for creating predefined fileviews. \fP"
.ti -1c
.RI "void \fBsetDirLister\fP (\fBKDirLister\fP *lister)"
.br
.RI "\fISets a custom KFileReader to list directories. \fP"
.ti -1c
.RI "void \fBresizeEvent\fP (\fBQResizeEvent\fP *)"
.br
.ti -1c
.RI "void \fBsetupActions\fP ()"
.br
.RI "\fISets up all the actions. \fP"
.ti -1c
.RI "void \fBupdateSortActions\fP ()"
.br
.RI "\fIUpdates the sorting-related actions to comply with the current sorting. \fP"
.ti -1c
.RI "void \fBupdateViewActions\fP ()"
.br
.RI "\fIUpdates the view-related actions to comply with the current KFile::FileView. \fP"
.ti -1c
.RI "void \fBsetupMenu\fP ()"
.br
.RI "\fISets up the context-menu with all the necessary actions. \fP"
.ti -1c
.RI "void \fBprepareCompletionObjects\fP ()"
.br
.RI "\fISynchronizes the completion objects with the entries of the currently listed url. \fP"
.ti -1c
.RI "bool \fBcheckPreviewSupport\fP ()"
.br
.RI "\fIChecks if there support from \fBKIO::PreviewJob\fP for the currently shown files, taking \fBmimeFilter\fP() and \fBnameFilter\fP() into account Enables/disables the preview-action accordingly. \fP"
.ti -1c
.RI "virtual void \fBvirtual_hook\fP (int id, void *data)"
.br
.in -1c
.SH "Detailed Description"
.PP 
This widget works as a network transparent filebrowser. A widget for displaying files and browsing directories. 

You specify a URL to display and this url will be loaded via \fBKDirLister\fP. The user can browse through directories, highlight and select files, delete or rename files.
.PP
It supports different views, e.g. a detailed view (see \fBKFileDetailView\fP), a simple icon view (see \fBKFileIconView\fP), a combination of two views, separating directories and files (\fBKCombiView\fP).
.PP
Additionally, a preview view is available (see \fBKFilePreview\fP), which can show either a simple or detailed view and additionally a preview widget (see \fBsetPreviewWidget\fP()). \fBKImageFilePreview\fP is one implementation of a preview widget, that displays previews for all supported filetypes utilizing \fBKIO::PreviewJob\fP.
.PP
Currently, those classes don't support Drag&Drop out of the box -- there you have to use your own view-classes. You can use some DnD-aware views from Björn Sahlström <bjorn@kbear.org> until they will be integrated into this library. See http://devel-home.kde.org/~pfeiffer/DnD-classes.tar.gz
.PP
This widget is the one used in the \fBKFileDialog\fP.
.PP
Basic usage is like this: 
.PP
.nf

   KDirOperator *op = new KDirOperator( \fBKURL\fP( 'file:/home/gis' ), this );
   // some signals you might be interested in
   connect(op, SIGNAL(urlEntered(const KURL&)),
           SLOT(urlEntered(const KURL&)));
   connect(op, SIGNAL(\fBfileHighlighted(const KFileItem *)\fP),
           SLOT(\fBfileHighlighted(const KFileItem *)\fP));
   connect(op, SIGNAL(fileSelected(const KFileItem *)),
           SLOT(fileSelected(const KFileItem *)));
   connect(op, SIGNAL(finishedLoading()),
           SLOT(slotLoadingFinished()));
.PP
.PP
.PP
.nf
   op->readConfig( \fBKGlobal::config()\fP, 'Your KDiroperator ConfigGroup' );
   op->setView(KFile::Default);
 
.PP
.PP
This will create a childwidget of 'this' showing the directory contents of /home/gis in the default-view. The view is determined by the \fBreadConfig()\fP call, which will read the KDirOperator settings, the user left your program with (and which you saved with op->\fBwriteConfig()\fP).
.PP
\fBAuthor:\fP
.RS 4
Stephan Kulow <coolo@kde.org>, Carsten Pfeiffer <pfeiffer@kde.org> 
.RE
.PP

.PP
Definition at line 98 of file kdiroperator.h.
.SH "Member Enumeration Documentation"
.PP 
.SS "\fBenum\fP \fBKDirOperator::ActionTypes\fP"
.PP
The various action types. These values can be or'd together 
.PP
\fBSince:\fP
.RS 4
3.1 
.RE
.PP
Definition at line 107 of file kdiroperator.h.
.SH "Constructor & Destructor Documentation"
.PP 
.SS "KDirOperator::KDirOperator (const \fBKURL\fP & urlName = \fBKURL\fP(), \fBQWidget\fP * parent = 0, const char * name = 0)"
.PP
Constructs the KDirOperator with no initial view. As the views are configurable, call \fBreadConfig\fP() to load the user's configuration and then \fBsetView\fP to explicitly set a view.
.PP
This constructor doesn't start loading the url, \fBsetView\fP will do it. Definition at line 93 of file kdiroperator.cpp.
.PP
References KURL::addPath(), QString::append(), QDir::currentDirPath(), QString::fromLatin1(), QWidget::height(), QString::isEmpty(), KURL::isEmpty(), KURL::protocol(), QPtrStack< KURL >::setAutoDelete(), setDirLister(), QWidget::setFocusPolicy(), KURL::setPath(), KURL::setProtocol(), setupActions(), setupMenu(), and slotCompletionMatch().
.SS "KDirOperator::~\fBKDirOperator\fP ()\fC [virtual]\fP"
.PP
Destroys the KDirOperator. Definition at line 146 of file kdiroperator.cpp.
.PP
References resetCursor(), and KFileView::writeConfig().
.SH "Member Function Documentation"
.PP 
.SS "void KDirOperator::setShowHiddenFiles (bool s)\fC [inline]\fP"
.PP
Enables/disables showing hidden files. Definition at line 129 of file kdiroperator.h.
.PP
References KToggleAction::setChecked().
.SS "bool KDirOperator::showHiddenFiles () const\fC [inline]\fP"
.PP
\fBReturns:\fP
.RS 4
true when hidden files are shown or false otherwise. 
.RE
.PP
Definition at line 134 of file kdiroperator.h.
.PP
References KToggleAction::isChecked().
.SS "void KDirOperator::close ()"
.PP
Stops loading immediately. You don't need to call this, usually. Reimplemented from \fBQWidget\fP.
.PP
Definition at line 470 of file kdiroperator.cpp.
.PP
References KCompletion::clear(), QPtrList::clear(), resetCursor(), and KDirLister::stop().
.SS "void KDirOperator::setNameFilter (const \fBQString\fP & filter)"
.PP
Sets a filter like '*.cpp *.h *.o'. Only files matching that filter will be shown. Call \fBupdateDir\fP() to apply it.
.PP
\fBSee also:\fP
.RS 4
\fBKDirLister::setNameFilter\fP 
.PP
\fBnameFilter\fP 
.RE
.PP
Definition at line 683 of file kdiroperator.cpp.
.PP
References checkPreviewSupport(), and KDirLister::setNameFilter().
.PP
Referenced by KFileDialog::setFilter().
.SS "const \fBQString\fP& KDirOperator::nameFilter () const\fC [inline]\fP"
.PP
\fBReturns:\fP
.RS 4
the current namefilter. 
.RE
.PP
\fBSee also:\fP
.RS 4
\fBsetNameFilter\fP 
.RE
.PP
Definition at line 154 of file kdiroperator.h.
.PP
References KDirLister::nameFilter().
.SS "void KDirOperator::setMimeFilter (const \fBQStringList\fP & mimetypes)"
.PP
Sets a list of mimetypes as filter. Only files of those mimetypes will be shown.
.PP
Example: 
.PP
.nf

 \fBQStringList\fP filter;
 filter << 'text/html' << 'image/png' << 'inode/directory';
 dirOperator->setMimefilter( filter );
 
.PP
.PP
Node: Without the mimetype inode/directory, only files would be shown. Call \fBupdateDir\fP() to apply it.
.PP
\fBSee also:\fP
.RS 4
\fBKDirLister::setMimeFilter\fP 
.PP
\fBmimeFilter\fP 
.RE
.PP
Definition at line 689 of file kdiroperator.cpp.
.PP
References checkPreviewSupport(), and KDirLister::setMimeFilter().
.PP
Referenced by KFileDialog::setMimeFilter().
.SS "\fBQStringList\fP KDirOperator::mimeFilter () const\fC [inline]\fP"
.PP
\fBReturns:\fP
.RS 4
the current mime filter. 
.RE
.PP
Definition at line 178 of file kdiroperator.h.
.PP
References KDirLister::mimeFilters().
.SS "void KDirOperator::clearFilter ()"
.PP
Clears both the namefilter and mimetype filter, so that all files and directories will be shown. Call \fBupdateDir\fP() to apply it.
.PP
\fBSee also:\fP
.RS 4
\fBsetMimeFilter\fP 
.PP
\fBsetNameFilter\fP 
.RE
.PP
Definition at line 676 of file kdiroperator.cpp.
.PP
References checkPreviewSupport(), KDirLister::clearMimeFilter(), and KDirLister::setNameFilter().
.PP
Referenced by KFileDialog::clearFilter(), KFileDialog::setFilter(), and KFileDialog::setMimeFilter().
.SS "\fBKURL\fP KDirOperator::url () const"
.PP
\fBReturns:\fP
.RS 4
the current url 
.RE
.PP
Definition at line 659 of file kdiroperator.cpp.
.PP
Referenced by KFileDialog::baseURL(), del(), isRoot(), mkdir(), KFileDialog::readConfig(), KFileDialog::setSelection(), setView(), and KFileDialog::tokenize().
.SS "void KDirOperator::setURL (const \fBKURL\fP & url, bool clearforward)"
.PP
Sets a new url to list. \fBParameters:\fP
.RS 4
\fIclearforward\fP specifies whether the 'forward' history should be cleared. 
.RE
.PP
Definition at line 533 of file kdiroperator.cpp.
.PP
References KURL::cd(), QPtrStack< KURL >::clear(), KURL::cmp(), KMessageBox::error(), QString::fromLatin1(), QDir::homeDirPath(), QPtrStack< KURL >::isEmpty(), KURL::isMalformed(), isRoot(), KDirLister::openURL(), KURL::path(), pathChanged(), QPtrStack< KURL >::push(), resetCursor(), KAction::setEnabled(), KURL::setPath(), KURL::url(), and viewWidget().
.PP
Referenced by back(), cdUp(), forward(), home(), mkdir(), selectDir(), and KFileDialog::setURL().
.SS "void KDirOperator::setCurrentItem (const \fBQString\fP & filename)"
.PP
Clears the current selection and attempts to set \fCfilename\fP the current file. filename is just the name, no path or url. Definition at line 1049 of file kdiroperator.cpp.
.PP
References KFileView::clearSelection(), KFileView::ensureItemVisible(), KDirLister::findByName(), QString::isNull(), KFileView::setCurrentItem(), and KFileView::setSelected().
.PP
Referenced by slotCompletionMatch().
.SS "void KDirOperator::setView (\fBKFileView\fP * view)"
.PP
Sets a new \fBKFileView\fP to be used for showing and browsing files. Note: this will read the current \fBurl\fP() to fill the view.
.PP
\fBSee also:\fP
.RS 4
\fBKFileView\fP 
.PP
\fBKFileIconView\fP 
.PP
\fBKFileDetailView\fP 
.PP
KFileCombiView 
.PP
\fBview\fP 
.RE
.PP
Definition at line 964 of file kdiroperator.cpp.
.PP
References QWidget::setFocusProxy(), KFileView::setOnlyDoubleClickSelectsFiles(), KFileView::setSorting(), viewChanged(), and KFileView::widget().
.PP
Referenced by setMode(), setPreviewWidget(), and setView().
.SS "\fBKFileView\fP* KDirOperator::view () const\fC [inline]\fP"
.PP
\fBReturns:\fP
.RS 4
the currently used view. 
.RE
.PP
\fBSee also:\fP
.RS 4
\fBsetView\fP 
.RE
.PP
Definition at line 223 of file kdiroperator.h.
.SS "\fBQWidget\fP* KDirOperator::viewWidget () const\fC [inline]\fP"
.PP
Returns the widget of the current view. 0L if there is no view/widget. (\fBKFileView\fP itself is not a widget.) Definition at line 229 of file kdiroperator.h.
.PP
References KFileView::widget().
.PP
Referenced by mkdir(), pathChanged(), and setURL().
.SS "void KDirOperator::setView (KFile::FileView view)"
.PP
Sets one of the predefined fileviews. \fBSee also:\fP
.RS 4
KFile::FileView 
.RE
.PP
Definition at line 815 of file kdiroperator.cpp.
.PP
References KActionCollection::action(), createView(), KAction::isEnabled(), KFile::isPreviewInfo(), mode(), KToggleAction::setChecked(), KAction::setEnabled(), setView(), and url().
.SS "void KDirOperator::setSorting (QDir::SortSpec)"
.PP
Sets the way to sort files and directories. Definition at line 164 of file kdiroperator.cpp.
.PP
References KFileView::setSorting(), and updateSortActions().
.PP
Referenced by readConfig().
.SS "QDir::SortSpec KDirOperator::sorting () const\fC [inline]\fP"
.PP
\fBReturns:\fP
.RS 4
the current way of sorting files and directories 
.RE
.PP
Definition at line 245 of file kdiroperator.h.
.SS "bool KDirOperator::isRoot () const\fC [inline]\fP"
.PP
\fBReturns:\fP
.RS 4
true if we are displaying the root directory of the current url 
.RE
.PP
Definition at line 250 of file kdiroperator.h.
.PP
References KURL::path(), and url().
.PP
Referenced by setURL().
.SS "\fBKDirLister\fP* KDirOperator::dirLister () const\fC [inline]\fP"
.PP
\fBReturns:\fP
.RS 4
the object listing the directory 
.RE
.PP
Definition at line 255 of file kdiroperator.h.
.SS "\fBKProgress\fP * KDirOperator::progressBar () const"
.PP
\fBReturns:\fP
.RS 4
the progress widget, that is shown during directory listing. You can for example \fBreparent()\fP it to put it into a statusbar. 
.RE
.PP
Definition at line 1471 of file kdiroperator.cpp.
.SS "void KDirOperator::setMode (\fBKFile::Mode\fP m)"
.PP
Sets the listing/selection mode for the views, an OR'ed combination of 
.IP "\(bu" 2
File 
.IP "\(bu" 2
Directory 
.IP "\(bu" 2
Files 
.IP "\(bu" 2
ExistingOnly 
.IP "\(bu" 2
LocalOnly. 
.PP
You cannot mix File and Files of course, as the former means single-selection mode, the latter multi-selection. Definition at line 951 of file kdiroperator.cpp.
.PP
References dirOnlyMode(), KDirLister::setDirOnlyMode(), and setView().
.PP
Referenced by KFileDialog::setMode().
.SS "\fBKFile::Mode\fP KDirOperator::mode () const"
.PP
\fBReturns:\fP
.RS 4
the listing/selection mode. 
.RE
.PP
Definition at line 946 of file kdiroperator.cpp.
.PP
References KFile::Mode.
.PP
Referenced by KFileDialog::init(), KFileDialog::mode(), KFileDialog::selectedFiles(), KFileDialog::selectedURLs(), and setView().
.SS "void KDirOperator::setPreviewWidget (const \fBQWidget\fP * w)"
.PP
Sets a preview-widget to be shown next to the file-view. The ownership of \fCw\fP is transferred to KDirOperator, so don't delete it yourself! Definition at line 244 of file kdiroperator.cpp.
.PP
References KActionCollection::action(), KToggleAction::setChecked(), KAction::setEnabled(), and setView().
.PP
Referenced by KFileDialog::setPreviewWidget().
.SS "const \fBKFileItemList\fP* KDirOperator::selectedItems () const\fC [inline]\fP"
.PP
\fBReturns:\fP
.RS 4
a list of all currently selected items. If there is no view, then 0L is returned. 
.RE
.PP
Definition at line 291 of file kdiroperator.h.
.PP
References KFileView::selectedItems().
.PP
Referenced by KFileDialog::multiSelectionChanged().
.SS "bool KDirOperator::isSelected (const \fBKFileItem\fP * item) const\fC [inline]\fP"
.PP
\fBReturns:\fP
.RS 4
true if \fCitem\fP is currently selected, or false otherwise. 
.RE
.PP
Definition at line 298 of file kdiroperator.h.
.PP
References KFileView::isSelected().
.SS "int KDirOperator::numDirs () const"
.PP
\fBReturns:\fP
.RS 4
the number of directories in the currently listed url. Returns 0 if there is no view. 
.RE
.PP
Definition at line 260 of file kdiroperator.cpp.
.PP
References KFileView::numDirs().
.SS "int KDirOperator::numFiles () const"
.PP
\fBReturns:\fP
.RS 4
the number of files in the currently listed url. Returns 0 if there is no view. 
.RE
.PP
Definition at line 265 of file kdiroperator.cpp.
.PP
References KFileView::numFiles().
.SS "\fBKCompletion\fP* KDirOperator::completionObject () const\fC [inline]\fP"
.PP
\fBReturns:\fP
.RS 4
a \fBKCompletion\fP object, containing all filenames and directories of the current directory/URL. You can use it to insert it into a \fBKLineEdit\fP or \fBKComboBox\fP Note: it will only contain files, after \fBprepareCompletionObjects\fP() has been called. It will be implicitly called from \fBmakeCompletion\fP() or \fBmakeDirCompletion\fP() 
.RE
.PP
Definition at line 322 of file kdiroperator.h.
.PP
Referenced by KFileDialog::init().
.SS "\fBKCompletion\fP* KDirOperator::dirCompletionObject () const\fC [inline]\fP"
.PP
\fBReturns:\fP
.RS 4
a \fBKCompletion\fP object, containing only all directories of the current directory/URL. You can use it to insert it into a \fBKLineEdit\fP or \fBKComboBox\fP Note: it will only contain directories, after \fBprepareCompletionObjects\fP() has been called. It will be implicitly called from \fBmakeCompletion\fP() or \fBmakeDirCompletion\fP() 
.RE
.PP
Definition at line 334 of file kdiroperator.h.
.PP
Referenced by KFileDialog::init().
.SS "\fBKActionCollection\fP* KDirOperator::actionCollection () const\fC [inline]\fP"
.PP
an accessor to a collection of all available Actions. The actions are static, they will be there all the time (no need to connect to the signals \fBKActionCollection::inserted()\fP or removed().
.PP
There are the following actions:
.PP
.IP "\(bu" 2
popupMenu : an ActionMenu presenting a popupmenu with all actions 
.IP "\(bu" 2
up : changes to the parent directory 
.IP "\(bu" 2
back : goes back to the previous directory 
.IP "\(bu" 2
forward : goes forward in the history 
.IP "\(bu" 2
home : changes to the user's home directory 
.IP "\(bu" 2
reload : reloads the current directory 
.IP "\(bu" 2
separator : a separator 
.IP "\(bu" 2
mkdir : opens a dialog box to create a directory 
.IP "\(bu" 2
delete : deletes the selected files/directories 
.IP "\(bu" 2
sorting menu : an ActionMenu containing all sort-options 
.IP "\(bu" 2
by name : sorts by name 
.IP "\(bu" 2
by date : sorts by date 
.IP "\(bu" 2
by size : sorts by size 
.IP "\(bu" 2
reversed : reverses the sort order 
.IP "\(bu" 2
dirs first : sorts directories before files 
.IP "\(bu" 2
case insensitive : sorts case insensitively 
.IP "\(bu" 2
view menu : an ActionMenu containing all actions concerning the view 
.IP "\(bu" 2
short view : shows a simple fileview 
.IP "\(bu" 2
detailed view : shows a detailed fileview (dates, permissions ,...) 
.IP "\(bu" 2
show hidden : shows hidden files 
.IP "\(bu" 2
separate dirs : shows directories in a separate pane 
.IP "\(bu" 2
preview : shows a preview next to the fileview 
.IP "\(bu" 2
single : hides the separate view for directories or the preview 
.IP "\(bu" 2
properties : shows a \fBKPropertiesDialog\fP for the selected files
.PP
The short and detailed view are in an exclusive group. The sort-by actions are in an exclusive group as well. Also the 'separate dirs', 'preview' and 'single' actions are in an exclusive group.
.PP
You can e.g. use 
.PP
.nf
\fBactionCollection()\fP->action( 'up' )->plug( someToolBar );
.PP
 to add a button into a toolbar, which makes the dirOperator change to its parent directory.
.PP
\fBReturns:\fP
.RS 4
all available Actions 
.RE
.PP
Definition at line 381 of file kdiroperator.h.
.PP
Referenced by KFileDialog::actionCollection(), KFileDialog::init(), and KFileDialog::toggleSpeedbar().
.SS "void KDirOperator::setViewConfig (\fBKConfig\fP * config, const \fBQString\fP & group)"
.PP
Sets the config object and the to be used group in KDirOperator. This will be used to store the view's configuration via \fBKFileView::writeConfig\fP() (and for \fBKFileView::readConfig\fP()). If you don't set this, the views cannot save and restore their configuration.
.PP
Usually you call this right after KDirOperator creation so that the view instantiation can make use of it already.
.PP
Note that KDirOperator does NOT take ownership of that object (typically it's \fBKGlobal::config()\fP anyway.
.PP
\fBSee also:\fP
.RS 4
\fBviewConfig\fP 
.PP
\fBviewConfigGroup\fP 
.RE
.PP
\fBSince:\fP
.RS 4
3.1 
.RE
.PP
Definition at line 1569 of file kdiroperator.cpp.
.PP
Referenced by KFileDialog::init().
.SS "\fBKConfig\fP * KDirOperator::viewConfig ()"
.PP
Returns the \fBKConfig\fP object used for saving and restoring view's configuration. \fBReturns:\fP
.RS 4
the \fBKConfig\fP object used for saving and restoring view's configuration. 
.RE
.PP
\fBSince:\fP
.RS 4
3.1 
.RE
.PP
Definition at line 1575 of file kdiroperator.cpp.
.SS "\fBQString\fP KDirOperator::viewConfigGroup () const"
.PP
Returns the group name used for saving and restoring view's configuration. \fBReturns:\fP
.RS 4
the group name used for saving and restoring view's configuration. 
.RE
.PP
\fBSince:\fP
.RS 4
3.1 
.RE
.PP
Definition at line 1580 of file kdiroperator.cpp.
.SS "void KDirOperator::readConfig (\fBKConfig\fP *, const \fBQString\fP & group = QString::null)\fC [virtual]\fP"
.PP
Reads the default settings for a view, i.e. the default KFile::FileView. Also reads the sorting and whether hidden files should be shown. Note: the default view will not be set - you have to call 
.PP
.nf

 setView( KFile::Default )
 
.PP
 to apply it.
.PP
\fBSee also:\fP
.RS 4
\fBsetView\fP 
.PP
\fBsetViewConfig\fP 
.PP
\fBwriteConfig\fP 
.RE
.PP
Definition at line 1288 of file kdiroperator.cpp.
.PP
References QString::fromLatin1(), KConfigBase::group(), QString::isEmpty(), KStdAccel::name(), KConfigBase::readBoolEntry(), KConfigBase::readEntry(), KToggleAction::setChecked(), KConfigBase::setGroup(), KDirLister::setShowingDotFiles(), and setSorting().
.PP
Referenced by KFileDialog::readConfig().
.SS "void KDirOperator::writeConfig (\fBKConfig\fP *, const \fBQString\fP & group = QString::null)\fC [virtual]\fP"
.PP
Saves the current settings like sorting, simple or detailed view. \fBSee also:\fP
.RS 4
\fBreadConfig\fP 
.PP
\fBsetViewConfig\fP 
.RE
.PP
Definition at line 1346 of file kdiroperator.cpp.
.PP
References KActionCollection::action(), QString::fromLatin1(), KConfigBase::group(), KToggleAction::isChecked(), QString::isEmpty(), KAction::isEnabled(), KConfigBase::setGroup(), QWidget::style(), and KConfigBase::writeEntry().
.PP
Referenced by KFileDialog::writeConfig().
.SS "void KDirOperator::setOnlyDoubleClickSelectsFiles (bool enable)"
.PP
This is a \fBKFileDialog\fP specific hack: we want to select directories with single click, but not files. But as a generic class, we have to be able to select files on single click as well.
.PP
This gives us the opportunity to do both.
.PP
The default is false, set it to true if you don't want files selected with single click. Definition at line 1415 of file kdiroperator.cpp.
.PP
References KFileView::setOnlyDoubleClickSelectsFiles().
.PP
Referenced by KFileDialog::init().
.SS "bool KDirOperator::onlyDoubleClickSelectsFiles () const"
.PP
\fBReturns:\fP
.RS 4
whether files (not directories) should only be select()ed by double-clicks. 
.RE
.PP
\fBSee also:\fP
.RS 4
\fBsetOnlyDoubleClickSelectsFiles\fP 
.RE
.PP
Definition at line 1422 of file kdiroperator.cpp.
.SS "bool KDirOperator::mkdir (const \fBQString\fP & directory, bool enterDirectory = true)"
.PP
Creates the given directory/url. If it is a relative path, it will be completed with the current directory. If enterDirectory is true, the directory will be entered after a successful operation. If unsuccessful, a messagebox will be presented to the user. 
.PP
\fBReturns:\fP
.RS 4
true if the directory could be created. 
.RE
.PP
Definition at line 376 of file kdiroperator.cpp.
.PP
References KURL::addPath(), KURL::isLocalFile(), KIO::NetAccess::mkdir(), KURL::path(), setURL(), KMessageBox::sorry(), url(), and viewWidget().
.SS "\fBKIO::DeleteJob\fP * KDirOperator::del (const \fBKFileItemList\fP & items, bool ask = true, bool showProgress = true)"
.PP
Starts and returns a \fBKIO::DeleteJob\fP to delete the given \fCitems\fP. \fBParameters:\fP
.RS 4
\fIask\fP specifies whether a confirmation dialog should be shown 
.br
\fIshowProgress\fP passed to the DeleteJob to show a progress dialog 
.RE
.PP
Definition at line 402 of file kdiroperator.cpp.
.PP
Referenced by deleteSelected().
.SS "\fBKIO::DeleteJob\fP * KDirOperator::del (const \fBKFileItemList\fP & items, \fBQWidget\fP * parent, bool ask = true, bool showProgress = true)"
.PP
Starts and returns a \fBKIO::DeleteJob\fP to delete the given \fCitems\fP. \fBParameters:\fP
.RS 4
\fIparent\fP the parent widget used for the confirmation dialog 
.br
\fIask\fP specifies whether a confirmation dialog should be shown 
.br
\fIshowProgress\fP passed to the DeleteJob to show a progress dialog 
.RE
.PP
\fBSince:\fP
.RS 4
3.1 
.RE
.PP
Definition at line 408 of file kdiroperator.cpp.
.PP
References QValueList< KURL >::append(), QPtrList::count(), QPtrListIterator::current(), KIO::del(), KMessageBox::information(), QPtrList::isEmpty(), KURL::isLocalFile(), KURL::path(), KURL::prettyURL(), KIO::Job::setAutoErrorHandlingEnabled(), KURL::url(), url(), KMessageBox::warningContinueCancel(), and KMessageBox::warningContinueCancelList().
.SS "void KDirOperator::clearHistory ()"
.PP
Clears the forward and backward history. Definition at line 1476 of file kdiroperator.cpp.
.PP
References QPtrStack< KURL >::clear(), and KAction::setEnabled().
.PP
Referenced by KFileDialog::getExistingDirectory(), KFileDialog::getExistingURL(), KFileDialog::getOpenFileName(), KFileDialog::getOpenFileNames(), KFileDialog::getOpenURL(), KFileDialog::getOpenURLs(), and KFileDialog::setPreviewWidget().
.SS "void KDirOperator::setEnableDirHighlighting (bool enable)"
.PP
When going up in the directory hierarchy, KDirOperator can highlight the directory that was just left. I.e. when you go from /home/gis/src to /home/gis, the item 'src' will be made the current item.
.PP
Default is off. Definition at line 1506 of file kdiroperator.cpp.
.SS "bool KDirOperator::dirHighlighting () const"
.PP
\fBReturns:\fP
.RS 4
whether the last directory will be made the current item when going up in the directory hierarchy.
.RE
.PP
Default is false. Definition at line 1511 of file kdiroperator.cpp.
.SS "bool KDirOperator::dirOnlyMode () const\fC [inline]\fP"
.PP
\fBReturns:\fP
.RS 4
true if we are in directory-only mode, that is, no files are shown. 
.RE
.PP
Definition at line 521 of file kdiroperator.h.
.PP
Referenced by KFileDialog::setMode(), and setMode().
.SS "void KDirOperator::setupMenu (int whichActions)"
.PP
Sets up the action menu. \fBParameters:\fP
.RS 4
\fIactionTypes\fP is an value of OR'd \fBActionTypes\fP that controls which actions to show in the action menu 
.RE
.PP
Definition at line 1212 of file kdiroperator.cpp.
.PP
References KActionCollection::action(), QPopupMenu::clear(), KActionMenu::insert(), and KActionMenu::popupMenu().
.PP
Referenced by KFileDialog::init().
.SS "\fBKFileView\fP * KDirOperator::createView (\fBQWidget\fP * parent, KFile::FileView view)\fC [protected, virtual]\fP"
.PP
A view factory for creating predefined fileviews. Called internally by \fBsetView\fP , but you can also call it directly. Reimplement this if you depend on self defined fileviews. 
.PP
\fBParameters:\fP
.RS 4
\fIparent\fP is the \fBQWidget\fP to be set as parent 
.br
\fIview\fP is the predefined view to be set, note: this can be several ones OR:ed together. 
.RE
.PP
\fBReturns:\fP
.RS 4
the created \fBKFileView\fP 
.RE
.PP
\fBSee also:\fP
.RS 4
\fBKFileView\fP 
.PP
\fBKCombiView\fP 
.PP
\fBKFileDetailView\fP 
.PP
\fBKFileIconView\fP 
.PP
\fBKFilePreview\fP 
.PP
KFile::FileView 
.PP
\fBsetView\fP 
.RE
.PP
Definition at line 769 of file kdiroperator.cpp.
.PP
References KFile::isPreviewInfo(), KFileView::setOnlyDoubleClickSelectsFiles(), KCombiView::setRight(), and KFileView::setViewName().
.PP
Referenced by setView().
.SS "void KDirOperator::setDirLister (\fBKDirLister\fP * lister)\fC [protected]\fP"
.PP
Sets a custom KFileReader to list directories. Definition at line 978 of file kdiroperator.cpp.
.PP
References insertNewFiles(), itemDeleted(), and KDirLister::setAutoUpdate().
.PP
Referenced by KDirOperator().
.SS "void KDirOperator::setupActions ()\fC [protected]\fP"
.PP
Sets up all the actions. Called from the constructor, you usually better not call this. Definition at line 1112 of file kdiroperator.cpp.
.PP
References back(), KStdAction::back(), cdUp(), deleteSelected(), forward(), KStdAction::forward(), QString::fromLatin1(), home(), KStdAction::home(), mkdir(), KActionMenu::popupMenu(), KStdAction::redisplay(), rereadDir(), KToggleAction::setExclusiveGroup(), KAction::setIcon(), KAction::setShortcut(), KAction::setText(), and KStdAction::up().
.PP
Referenced by KDirOperator().
.SS "void KDirOperator::updateSortActions ()\fC [protected]\fP"
.PP
Updates the sorting-related actions to comply with the current sorting. \fBSee also:\fP
.RS 4
\fBsorting\fP 
.RE
.PP
Definition at line 1260 of file kdiroperator.cpp.
.PP
References KFileView::isReversed(), KToggleAction::setChecked(), and KAction::setEnabled().
.PP
Referenced by setSorting().
.SS "void KDirOperator::updateViewActions ()\fC [protected]\fP"
.PP
Updates the view-related actions to comply with the current KFile::FileView. Definition at line 1277 of file kdiroperator.cpp.
.PP
References KAction::isEnabled(), and KToggleAction::setChecked().
.SS "void KDirOperator::setupMenu ()\fC [protected]\fP"
.PP
Sets up the context-menu with all the necessary actions. Called from the constructor, you usually don't need to call this. 
.PP
\fBSince:\fP
.RS 4
3.1 
.RE
.PP
Definition at line 1207 of file kdiroperator.cpp.
.PP
Referenced by KDirOperator().
.SS "void KDirOperator::prepareCompletionObjects ()\fC [protected]\fP"
.PP
Synchronizes the completion objects with the entries of the currently listed url. Automatically called from \fBmakeCompletion\fP() and \fBmakeDirCompletion\fP() Definition at line 1088 of file kdiroperator.cpp.
.PP
References KCompletion::addItem(), QPtrListIterator::current(), KFileItem::isDir(), KFileView::items(), and KFileItem::name().
.PP
Referenced by makeCompletion(), and makeDirCompletion().
.SS "bool KDirOperator::checkPreviewSupport ()\fC [protected]\fP"
.PP
Checks if there support from \fBKIO::PreviewJob\fP for the currently shown files, taking \fBmimeFilter\fP() and \fBnameFilter\fP() into account Enables/disables the preview-action accordingly. Definition at line 695 of file kdiroperator.cpp.
.PP
References KActionCollection::action(), KGlobal::config(), KConfigBase::readBoolEntry(), and KAction::setEnabled().
.PP
Referenced by clearFilter(), setMimeFilter(), and setNameFilter().
.SS "void KDirOperator::back ()\fC [slot]\fP"
.PP
Goes one step back in the history and opens that url. Definition at line 633 of file kdiroperator.cpp.
.PP
References QPtrStack< KURL >::isEmpty(), QPtrStack< KURL >::pop(), QPtrStack< KURL >::push(), and setURL().
.PP
Referenced by pathChanged(), and setupActions().
.SS "void KDirOperator::forward ()\fC [slot]\fP"
.PP
Goes one step forward in the history and opens that url. Definition at line 647 of file kdiroperator.cpp.
.PP
References QPtrStack< KURL >::isEmpty(), QPtrStack< KURL >::pop(), QPtrStack< KURL >::push(), and setURL().
.PP
Referenced by setupActions().
.SS "void KDirOperator::home ()\fC [slot]\fP"
.PP
Enters the home directory. Definition at line 671 of file kdiroperator.cpp.
.PP
References QDir::homeDirPath(), and setURL().
.PP
Referenced by pathChanged(), and setupActions().
.SS "void KDirOperator::cdUp ()\fC [slot]\fP"
.PP
Goes one directory up from the current url. Definition at line 664 of file kdiroperator.cpp.
.PP
References KURL::cd(), QString::fromLatin1(), and setURL().
.PP
Referenced by setupActions().
.SS "void KDirOperator::updateDir ()\fC [slot]\fP"
.PP
to update the view after changing the settings Definition at line 581 of file kdiroperator.cpp.
.PP
References KDirLister::emitChanges(), and KFileView::listingCompleted().
.SS "void KDirOperator::rereadDir ()\fC [slot]\fP"
.PP
Re-reads the current url. Definition at line 588 of file kdiroperator.cpp.
.PP
References KDirLister::openURL(), and pathChanged().
.PP
Referenced by setupActions().
.SS "void KDirOperator::mkdir ()\fC [slot]\fP"
.PP
Opens a dialog to create a new directory. Definition at line 365 of file kdiroperator.cpp.
.PP
References QDialog::exec(), QString::fromLatin1(), KDialog::setCaption(), KLineEditDlg::text(), and url().
.PP
Referenced by setupActions().
.SS "void KDirOperator::deleteSelected ()\fC [slot]\fP"
.PP
Deletes the currently selected files/directories. Definition at line 460 of file kdiroperator.cpp.
.PP
References del(), and KFileView::selectedItems().
.PP
Referenced by setupActions().
.SS "void KDirOperator::updateSelectionDependentActions ()\fC [slot]\fP"
.PP
Enables/disables actions that are selection dependent. Call this e.g. when you are about to show a popup menu using some of KDirOperators actions. Definition at line 236 of file kdiroperator.cpp.
.PP
References KActionCollection::action(), QPtrList::isEmpty(), KFileView::selectedItems(), and KAction::setEnabled().
.PP
Referenced by activatedMenu().
.SS "\fBQString\fP KDirOperator::makeCompletion (const \fBQString\fP &)\fC [slot]\fP"
.PP
Tries to complete the given string (only completes files). Definition at line 1066 of file kdiroperator.cpp.
.PP
References KFileView::clearSelection(), QString::isEmpty(), KCompletion::makeCompletion(), and prepareCompletionObjects().
.SS "\fBQString\fP KDirOperator::makeDirCompletion (const \fBQString\fP &)\fC [slot]\fP"
.PP
Tries to complete the given string (only completes directores). Definition at line 1077 of file kdiroperator.cpp.
.PP
References KFileView::clearSelection(), QString::isEmpty(), KCompletion::makeCompletion(), and prepareCompletionObjects().
.SS "void KDirOperator::resetCursor ()\fC [protected, slot]\fP"
.PP
Restores the normal cursor after showing the busy-cursor. Also hides the progressbar. Definition at line 172 of file kdiroperator.cpp.
.PP
References QApplication::restoreOverrideCursor().
.PP
Referenced by close(), insertNewFiles(), setURL(), and ~KDirOperator().
.SS "void KDirOperator::pathChanged ()\fC [protected, slot]\fP"
.PP
Called after \fBsetURL\fP() to load the directory, update the history, etc. Definition at line 595 of file kdiroperator.cpp.
.PP
References back(), KCompletion::clear(), KFileView::clear(), QPtrList::clear(), KMessageBox::error(), home(), QPtrStack< KURL >::isEmpty(), QApplication::restoreOverrideCursor(), QApplication::setOverrideCursor(), and viewWidget().
.PP
Referenced by rereadDir(), and setURL().
.SS "void KDirOperator::insertNewFiles (const \fBKFileItemList\fP & newone)\fC [protected, slot]\fP"
.PP
Adds a new list of KFileItems to the view (coming from \fBKDirLister\fP). Definition at line 1004 of file kdiroperator.cpp.
.PP
References KFileView::addItemList(), QPtrListIterator::current(), KFileView::ensureItemVisible(), KFileItem::isDir(), QPtrList::isEmpty(), KFileView::numDirs(), KFileView::numFiles(), resetCursor(), KFileView::setCurrentItem(), QTimer::singleShot(), KURL::url(), and KFileItem::url().
.PP
Referenced by setDirLister().
.SS "void KDirOperator::itemDeleted (\fBKFileItem\fP *)\fC [protected, slot]\fP"
.PP
Removes the given \fBKFileItem\fP item from the view (usually called from \fBKDirLister\fP). Definition at line 1035 of file kdiroperator.cpp.
.PP
References KFileView::numDirs(), KFileView::numFiles(), KFileView::removeItem(), and QPtrList::removeRef().
.PP
Referenced by setDirLister().
.SS "void KDirOperator::selectDir (const \fBKFileItem\fP * item)\fC [protected, slot]\fP"
.PP
Enters the directory specified by the given \fCitem\fP. Definition at line 1030 of file kdiroperator.cpp.
.PP
References setURL(), and KFileItem::url().
.SS "void KDirOperator::selectFile (const \fBKFileItem\fP * item)\fC [protected, slot]\fP"
.PP
Emits fileSelected( item ). Definition at line 1042 of file kdiroperator.cpp.
.PP
References QApplication::restoreOverrideCursor().
.SS "void KDirOperator::highlightFile (const \fBKFileItem\fP * i)\fC [inline, protected, slot]\fP"
.PP
Emits fileHighlighted( i ). Definition at line 697 of file kdiroperator.h.
.PP
References fileHighlighted().
.SS "void KDirOperator::activatedMenu (const \fBKFileItem\fP *, const \fBQPoint\fP & pos)\fC [protected, virtual, slot]\fP"
.PP
Called upon right-click to activate the popupmenu. Definition at line 229 of file kdiroperator.cpp.
.PP
References KActionMenu::popup(), and updateSelectionDependentActions().
.SS "void KDirOperator::sortByName ()\fC [inline, protected, slot]\fP"
.PP
Changes sorting to sort by name. Definition at line 707 of file kdiroperator.h.
.PP
References KToggleAction::setChecked().
.SS "void KDirOperator::sortBySize ()\fC [inline, protected, slot]\fP"
.PP
Changes sorting to sort by size. Definition at line 712 of file kdiroperator.h.
.PP
References KToggleAction::setChecked().
.SS "void KDirOperator::sortByDate ()\fC [inline, protected, slot]\fP"
.PP
Changes sorting to sort by date. Definition at line 717 of file kdiroperator.h.
.PP
References KToggleAction::setChecked().
.SS "void KDirOperator::sortReversed ()\fC [inline, protected, slot]\fP"
.PP
Changes sorting to reverse sorting. Definition at line 722 of file kdiroperator.h.
.PP
References KToggleAction::isChecked(), and KToggleAction::setChecked().
.SS "void KDirOperator::toggleDirsFirst ()\fC [inline, protected, slot]\fP"
.PP
Toggles showing directories first / having them sorted like files. Definition at line 727 of file kdiroperator.h.
.PP
References KToggleAction::isChecked(), and KToggleAction::setChecked().
.SS "void KDirOperator::toggleIgnoreCase ()\fC [inline, protected, slot]\fP"
.PP
Toggles case sensitive / case insensitive sorting. Definition at line 732 of file kdiroperator.h.
.PP
References KToggleAction::isChecked(), and KToggleAction::setChecked().
.SS "void KDirOperator::slotCompletionMatch (const \fBQString\fP & match)\fC [protected, slot]\fP"
.PP
Tries to make the given \fCmatch\fP as current item in the view and emits completion( match ). Definition at line 1106 of file kdiroperator.cpp.
.PP
References setCurrentItem().
.PP
Referenced by KDirOperator().
.SS "void KDirOperator::viewChanged (\fBKFileView\fP * newView)\fC [signal]\fP"
.PP
Emitted whenever the current fileview is changed, either by an explicit call to \fBsetView\fP() or by the user selecting a different view thru the GUI. Referenced by setView().
.SS "void KDirOperator::fileHighlighted (const \fBKFileItem\fP * item)\fC [signal]\fP"
.PP
Emitted when a file is highlighted or generally the selection changes in multiselection mode. In the latter case, \fCitem\fP is 0L. You can access the selected items with \fBselectedItems\fP(). Referenced by highlightFile().

.SH "Author"
.PP 
Generated automatically by Doxygen for kio Library from the source code.
