|
|
The dir lister deals with the kiojob used to list and update a directory, handles the timer, and has signals for the user of this class (e.g. konqueror view or kdesktop) to create/destroy its items when asked.
This class is independent from the graphical representation of the dir (icon container, tree view, ...) and it stores the items (as KFileItems).
Typical usage : Create an instance, Connect to at least update, clear, newItem, and deleteItem Call openURL - the signals will be called Reuse the instance when opening a new url (openURL) Destroy the instance when not needed anymore (usually destructor)
Advanced usage : call openURL with _bKeep = true to list directories without forgetting the ones previously read (e.g. for a tree view)
|
Create a directory lister
~ |
[virtual]
Destroy the directory lister
void |
[virtual]
Run the directory lister on the given url
Parameters:
_url | the directory URL |
_showDotFiles | whether to return the "hidden" files |
_keep | if true the previous directories aren't forgotten (they are still watched by kdirwatch and their items are kept in m_lstFileItems) |
void |
[virtual]
Stop listing the current directory
const KURL & |
[const virtual]
Returns: the url used by this instance to list the files It might be different from the one we gave, if there was a redirection.
void |
[virtual]
Update the currently displayed directory The current implementation calls it automatically for local files, using KDirWatch, but it might be useful to force an update manually.
void |
[virtual]
Changes the "is viewing dot files" setting. Calls updateDirectory() if setting changed
KFileItem* |
Find an item
Parameters:
_url | the item URL |
Returns: the pointer to the KFileItem
QList<KFileItem> & |
Returns: the list of file items currently displayed
KFileItem * |
Returns: the file item for url() itself (".")
void |
Set a name filter to only list items matching this name, e.g. "*.cpp".
You can set more than one filter by separating them with whitespace, e.g "*.cpp *.h". Call setNameFilter( QString::null ) to disable filtering.
bool |
[const]
Returns: true if @param name matches a filter in the list, otherwise fale.
void |
[signal]
Tell the view that we started to list _url. The view knows that openURL should start it, so it might seem useless, but the view also needs to know when an automatic update happens.
void |
[signal]
Tell the view that listing is finished
void |
[signal]
Tell the view that user canceled the listing
void |
[signal]
Signal a redirection
void |
[signal]
Clear all items
void |
[signal]
Signal new items
void |
[signal]
Signal a item to remove
KFileItem * |
[protected virtual]
called to create a KFileItem - you may subclass and reimplement this method if you use "special KFileItems", i.e. a subclass like KonqFileItem Must return a valid KFileItem
bool |
[protected virtual]
Called for every item after createFileItem().
Returns: false if the item shall not be shown in a view, e.g. files not matching a pattern *.cpp (KFileItem::isHidden()) You may reimplement this method in a subclass to implement your own filtering. The default implementation filters out ".." and everything not matching the name filter(s)
See also: matchesFilter, setNameFilter
void |
[protected]
Unregister dirs from kdirwatch and clear m_lstDirs
KURL |
[protected]
The url that we used to list (can be different in case of redirect)
QList<KFileItem> |
[protected]
The internal storage of file items
KFileItem * |
[protected]
File Item for m_url itself (".")
QStringList |
[protected]
List of dirs handled by this instance. Same as m_url if only one dir But for a tree view, it contains all the dirs shown (Used to unregister from kdirwatch)
QValueList<KIO::UDSEntry> |
[protected]
Keep entries found - used by slotUpdate*
bool |
[protected]
List only directories
QList<QRegExp> |
[protected]
a list of file-filters
Generated by: root@porky.devel.redhat.com on Wed May 10 08:56:52 2000, using kdoc 2.0a35. |