class KDirOperator

Public Methods

•  KDirOperator (const KURL& urlName = KURL(), QWidget *parent = 0, const char* name = 0)
• virtual  ~KDirOperator ()
• void  setShowHiddenFiles ( bool s )
• bool  showHiddenFiles () const
• void  close ()
• void  setNameFilter (const QString& filter)
• const QString&  nameFilter () const
• KURL  url () const
• void  setURL (const KURL& url, bool clearforward)
• void  setCurrentItem ( const QString& filename )
• void  setView (KFileView *view)
• const KFileView *  view () const
• QWidget *  viewWidget () const
• void  setView (KFile::FileView view)
• void  setSorting ( QDir::SortSpec )
• QDir::SortSpec  sorting () const
• bool  isRoot () const
• KFileReader * fileReader () const
• KProgress *  progressBar () const
• void  setMode ( KFile::Mode m )
• KFile::Mode  mode () const
• void  setPreviewWidget (const QWidget *w)
• const KFileViewItemList *  selectedItems () const
• inline bool  isSelected ( const KFileViewItem *item ) const
• int  numDirs () const
• int  numFiles () const
• KCompletion *  completionObject () const
• KCompletion * dirCompletionObject () const
• KActionCollection *  actionCollection () const
• virtual void  readConfig ( KConfig *, const QString& group = QString::null )
• virtual void  saveConfig ( KConfig *, const QString& group = QString::null )
• void  setOnlyDoubleClickSelectsFiles ( bool enable )
• bool  onlyDoubleClickSelectsFiles () const
• bool  mkdir ( const QString& directory, bool enterDirectory=true )
• void  clearHistory ()

Public Slots

• void  back ()
• void  forward ()
• void  home ()
• void  cdUp ()
• void  rereadDir ()
• void  mkdir ()
• QString  makeCompletion (const QString&)
• QString  makeDirCompletion (const QString&)

Signals

• void  urlEntered (const KURL& )
• void  updateInformation (int files, int dirs)
• void  completion (const QString&)
• void  finishedLoading ()
• void  viewChanged ( KFileView * newView )
• void  fileHighlighted (const KFileViewItem*)
• void  dirActivated (const KFileViewItem*)
• void  fileSelected (const KFileViewItem*)

Protected Methods

• void  setFileReader ( KFileReader *reader )
• void  resizeEvent ( QResizeEvent * )
• void  setupActions ()
• void  updateSortActions ()
• void  updateViewActions ()
• void  setupMenu ()
• void  prepareCompletionObjects ()

Protected Slots

• void  resetCursor ()
• void  readNextMimeType ()
• void  pathChanged ()
• void  filterChanged ()
• void  insertNewFiles (const KFileItemList &newone)
• void  itemDeleted (KFileItem *)
• void  selectDir (const KFileViewItem*)
• void  selectFile (const KFileViewItem*)
• void  highlightFile (const KFileViewItem* i)
• virtual void  activatedMenu ( const KFileViewItem * )
• void  sortByName ()
• void  sortBySize ()
• void  sortByDate ()
• void  sortReversed ()
• void  toggleDirsFirst ()
• void  toggleIgnoreCase ()
• void  deleteOldView ()
• void  slotCompletionMatch (const QString&)

Detailed Description

You need to call listDirectory() to actually load the directory, this constructor only initializes and doesn't start loading.

[virtual]

[const]

Reimplemented from QWidget.

Set a filter like "*.cpp *.h *.o". Call rereadDir() to apply it.

[const]

Returns: the current namefilter.

[const]

local URLs (i.e. directories) always have file: prepended.

Clears the current selection and attempts to set filename the current file. filename is just the name, no path or url.

[const]

[const]

Returns the widget of the current view. 0L if there is no view/widget.

[const]

[const]

[const]

[const]

Returns: the progress widget, that is shown during directory listing. You can for example reparent() it to put it into a statusbar.

Sets the listing/selection mode for the views, an OR'ed combination of

• File
• Directory
• Files
• ExistingOnly
• LocalOnly

You cannot mix File and Files of course.

[const]

[const]

Returns: a list of all currently selected items. If there is no view, then 0L is returned.

[const]

[const]

[const]

[const]

Returns: a KCompletion object, containing all filenames and directories of the current directory/URL. You can use it to insert it into a KLineEdit or KComboBox Note: it will only contain files, after prepareCompletionObjects() has been called. It will be implicitly called from makeCompletion() or makeDirCompletion()

[const]

Returns: a KCompletion object, containing only all directories of the current directory/URL. You can use it to insert it into a KLineEdit or KComboBox Note: it will only contain directories, after prepareCompletionObjects() has been called. It will be implicitly called from makeCompletion() or makeDirCompletion()

[const]

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 KActionCollection::inserted() or removed().

There are the following actions:

• popupMenu : an ActionMenu presenting a popupmenu with all actions
• up : changes to the parent directory
• back : goes back to the previous directory
• forward : goes forward in the history
• home : changes to the user's home directory
• reload : reloads the current directory
• separator : a separator
• mkdir : opens a dialog box to create a directory
• sorting menu : an ActionMenu containing all sort-options
• by name : sorts by name
• by date : sorts by date
• by size : sorts by size
• reversed : reverses the sort order
• dirs first : sorts directories before files
• case insensitive : sorts case insensitively
• view menu : an ActionMenu containing all actions concerning the view
• short view : shows a simple fileview
• detailed view : shows a detailed fileview (dates, permissions ,...)
• show hidden : shows hidden files
• separate dirs : shows directories in a separate pane

The short and detailed view are in an exclusive group. The sort-by actions are in an exclusive group as well.

You can e.g. use

actionCollection()->action( "up" )->plug( someToolBar );</pre>
 to add a button into a toolbar, which makes the dirOperator change to
 its parent directory.

 @returns all available Actions
     

[virtual]

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

@ref setView( KFile::Default )</pre> to apply it.
     

[virtual]

This is a KFileDialog 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.

This gives us the opportunity to do both.

The default is false, set it to true if you don't want files selected with single click.

[const]

Returns: whether files (not directories) should only be select()ed by double-clicks.

See also: setOnlyDoubleClickSelectsFiles

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.

Returns: true if the directory could be created.

Clears the forward and backward history.

[protected: ]

[protected: ]

Reimplemented from QWidget.

[protected: ]

[protected: ]

[protected: ]

[protected: ]

[protected: ]

[slot]

[slot]

[slot]

[slot]

[slot]

[slot]

[slot]

[slot]

[ protected slots: slot]

[ protected slots: slot]

[ protected slots: slot]

[ protected slots: slot]

[ protected slots: slot]

[ protected slots: slot]

[ protected slots: slot]

[ protected slots: slot]

[ protected slots: slot]

[ protected slots: virtual slot]

Called upon right-click to activate the popupmenu.

[ protected slots: slot]

[ protected slots: slot]

[ protected slots: slot]

[ protected slots: slot]

[ protected slots: slot]

[ protected slots: slot]

[ protected slots: slot]

[ protected slots: slot]

[signal]

[signal]

[signal]

[signal]

[signal]

Emitted whenever the current fileview is changed, either by an explicit call to setView() or by the user selecting a different view thru the GUI.

[signal]

[signal]

[signal]