kio Library API Documentation

KFileTreeView Class Reference

The filetreeview offers a treeview on the file system which behaves like a QTreeView showing files and/or directories in the file system. More...

#include <kfiletreeview.h>

Inheritance diagram for KFileTreeView:

KListView QListView List of all members.

Public Slots

virtual void setShowFolderOpenPixmap (bool showIt=true)
 set the flag to show 'extended' folder icons on or off.


Signals

void dropped (QDropEvent *, QListViewItem *)
void dropped (QDropEvent *, QListViewItem *, QListViewItem *)

Public Methods

KFileTreeViewItemcurrentKFileTreeViewItem () const
KURL currentURL () const
KFileTreeBranchaddBranch (const KURL &path, const QString &name, bool showHidden=false)
 Adds a branch to the treeview item.

virtual KFileTreeBranchaddBranch (const KURL &path, const QString &name, const QPixmap &pix, bool showHidden=false)
 same as the function above but with a pixmap to set for the branch.

virtual KFileTreeBranchaddBranch (KFileTreeBranch *)
 same as the function above but letting the user create the branch.

virtual bool removeBranch (KFileTreeBranch *branch)
 removes the branch from the treeview.

KFileTreeBranchbranch (const QString &searchName)
KFileTreeBranchList & branches ()
virtual void setDirOnlyMode (KFileTreeBranch *brnch, bool)
 set the directory mode for branches.

KFileTreeViewItemfindItem (KFileTreeBranch *brnch, const QString &relUrl)
 searches a branch for a KFileTreeViewItem identified by the relative url given as second parameter.

KFileTreeViewItemfindItem (const QString &branchName, const QString &relUrl)
 see method above, differs only in the first parameter.

bool showFolderOpenPixmap () const

Protected Methods

virtual bool acceptDrag (QDropEvent *event) const
virtual QDragObjectdragObject ()
virtual void contentsDragEnterEvent (QDragEnterEvent *e)
virtual void contentsDragMoveEvent (QDragMoveEvent *e)
virtual void contentsDragLeaveEvent (QDragLeaveEvent *e)
virtual void contentsDropEvent (QDropEvent *ev)

Detailed Description

The filetreeview offers a treeview on the file system which behaves like a QTreeView showing files and/or directories in the file system.

KFileTreeView is able to handle more than one URL, represented by KFileTreeBranch.

Typical usage: 1. create a KFileTreeView fitting in your layout and add columns to it 2. call addBranch to create one or more branches 3. retrieve the root item with KFileTreeBranch::root() and set it open if desired. That starts the listing.

Definition at line 66 of file kfiletreeview.h.


Member Function Documentation

KFileTreeViewItem * KFileTreeView::currentKFileTreeViewItem  
 

Returns:
the current (i.e. selected) item

Definition at line 557 of file kfiletreeview.cpp.

References QListView::selectedItem().

Referenced by currentURL().

KURL KFileTreeView::currentURL  
 

Returns:
the URL of the current selected item.

Definition at line 562 of file kfiletreeview.cpp.

References currentKFileTreeViewItem(), and KFileTreeViewItem::url().

Referenced by KDirSelectDialog::url().

KFileTreeBranch * KFileTreeView::addBranch const KURL   path,
const QString   name,
bool    showHidden = false
 

Adds a branch to the treeview item.

This high-level function creates the branch, adds it to the treeview and connects some signals. Note that directory listing does not start until a branch is expanded either by opening the root item by user or by setOpen on the root item.

Returns:
a pointer to the new branch or zero
Parameters:
path  is the base url of the branch
name  is the name of the branch, which will be the text for column 0
showHidden  says if hidden files and directories should be visible

Definition at line 338 of file kfiletreeview.cpp.

References KMimeType::mimeType().

Referenced by addBranch().

KFileTreeBranch * KFileTreeView::addBranch const KURL   path,
const QString   name,
const QPixmap   pix,
bool    showHidden = false
[virtual]
 

same as the function above but with a pixmap to set for the branch.

Definition at line 346 of file kfiletreeview.cpp.

References addBranch(), and KURL::prettyURL().

KFileTreeBranch * KFileTreeView::addBranch KFileTreeBranch   [virtual]
 

same as the function above but letting the user create the branch.

Definition at line 357 of file kfiletreeview.cpp.

References QPtrList< KFileTreeBranch >::append().

bool KFileTreeView::removeBranch KFileTreeBranch   branch [virtual]
 

removes the branch from the treeview.

Parameters:
branch  is a pointer to the branch
Returns:
true on success.

Definition at line 395 of file kfiletreeview.cpp.

References QPtrList< KFileTreeBranch >::contains(), QPtrList< KFileTreeBranch >::remove(), and KFileTreeBranch::root().

KFileTreeBranch * KFileTreeView::branch const QString   searchName
 

Returns:
a pointer to the KFileTreeBranch in the KFileTreeView or zero on failiure.
Parameters:
branchno  is the name of a branch

Definition at line 371 of file kfiletreeview.cpp.

References QPtrListIterator::current(), and KFileTreeBranch::name().

Referenced by findItem().

KFileTreeBranchList & KFileTreeView::branches  
 

Returns:
a list of pointers to all existing branches in the treeview.

Definition at line 389 of file kfiletreeview.cpp.

void KFileTreeView::setDirOnlyMode KFileTreeBranch   brnch,
bool   
[virtual]
 

set the directory mode for branches.

If true is passed, only directories will be loaded.

Parameters:
branch  is a pointer to a KFileTreeBranch

Definition at line 409 of file kfiletreeview.cpp.

References KDirLister::setDirOnlyMode().

KFileTreeViewItem * KFileTreeView::findItem KFileTreeBranch   brnch,
const QString   relUrl
 

searches a branch for a KFileTreeViewItem identified by the relative url given as second parameter.

The method adds the branches base url to the relative path and finds the item.

Returns:
a pointer to the item or zero if the item does not exist.
Parameters:
brnch  is a pointer to the branch to search in
relUrl  is the branch relativ url

Definition at line 596 of file kfiletreeview.cpp.

References KURL::addPath(), QString::endsWith(), KFileItem::extraData(), KDirLister::find(), QString::fromLatin1(), QString::isEmpty(), QString::length(), KURL::prettyURL(), KFileTreeBranch::root(), KFileTreeBranch::rootUrl(), and QString::truncate().

Referenced by findItem().

KFileTreeViewItem * KFileTreeView::findItem const QString   branchName,
const QString   relUrl
 

see method above, differs only in the first parameter.

Finds the branch by its name.

Definition at line 590 of file kfiletreeview.cpp.

References branch(), and findItem().

bool KFileTreeView::showFolderOpenPixmap   const [inline]
 

Returns:
a flag indicating if extended folder pixmaps are displayed or not.

Definition at line 152 of file kfiletreeview.h.

virtual void KFileTreeView::setShowFolderOpenPixmap bool    showIt = true [inline, virtual, slot]
 

set the flag to show 'extended' folder icons on or off.

If switched on, folders will have an open folder pixmap displayed if their children are visible, and the standard closed folder pixmap (from mimetype folder) if they are closed. If switched off, the plain mime pixmap is displayed.

Parameters:
showIt  = false displays mime type pixmap only

Definition at line 163 of file kfiletreeview.h.

bool KFileTreeView::acceptDrag QDropEvent   event const [protected, virtual]
 

Returns:
true if we can decode the drag and support the action

Reimplemented from KListView.

Definition at line 211 of file kfiletreeview.cpp.

References QDropEvent::action(), QUriDrag::canDecode(), and KListView::itemsMovable().


The documentation for this class was generated from the following files:
KDE Logo
This file is part of the documentation for kdelibs Version 3.1.0.
Documentation copyright © 1996-2002 the KDE developers.
Generated on Wed Oct 8 12:21:36 2003 by doxygen 1.2.18 written by Dimitri van Heesch, © 1997-2001