[kfile Index] [kfile Hierarchy] [Headers]
A base class for views of the KDE file selector More...
#include <kfileinfocontents.h>
A base class for views of the KDE file selector
This class defines an interface to all file views. It's intent is to allow to switch the view of the files in the selector very easily. It defines some pure virtual functions, that must be implemented to make a file view working.
Since this class is not a widget, but it's meant to be added to other widgets, its most important function is @code widget. This should return a pointer to the implemented widget.
[public]
It loads the icons used to indicate files and folders in all views, initializes some used lists and variables
useSingleClick | defines, if the view should react on single click or double click |
sorting | defines, how the list should be sorted. Currently Name, Size and Date are supported. |
[public virtual]
Destructor
[public virtual]
Insert an item into the file view. The view will just maintain the pointer. It doesn't free the object.
This functions inserts the file at the correct place in the sorted list
item | the file to be inserted |
[public virtual]
inserts a list of items. This is an speed optimized version of function above.
[public virtual]
a pure virtual function to get a QWidget, that can be added to other widgets. This function is needed to make it possible for derived classes to derive from other widgets.
[public virtual]
set the current item in the view.
the normal use of this function is to use the parameter filename to set the highlight on this file.
the extend use of this function is to set filename to 0. In this case the @see KFileInfo is used to find out the position of the file. Since this is faster, this way is used in case a view has other child views.
[public virtual]
set the autoUpdate flag for the specific widget. if set to false, no repaints should be done automaticly unless repaint is called.
this function is pure virtual, so it must be implemented
[public]
clears all lists and calls clearView
[public virtual]
does a repaint of the view.
The default implementation calls
widget()->repaint(f)
[public]
specifies the sorting of the internal list. Newly added files are added through this sorting.
[public]
set the sorting of the view. If the sorting is the same as the current value and sortMode is Switching, it switches the order in the list.
Default is QDir::Name
[public]
returns the number of added files
[public]
to connect a slot to the internal signal, that is emited, if the user selects a directory.
the connected slot must have the form
member(KFileInfo*)
[public]
to connect a slot to the internal signal, that is emited, if the user highlights a file.
the connected slot must have the form
member(KFileInfo*)
[public]
to connect a slot to the internal signal, that is emited, if the user selects a file.
the connected slot must have the form
member(KFileInfo*)
[public]
the number of files.
[public]
the number of directories
[public virtual]
tries to find a completed filename, that starts with base
if it fails, it returns a null string.
activateFound | if true, the file should select the found file (or directory) |
[public virtual]
a pure virtual function to indicate, if the view should list files.
[public virtual]
a pure virtual function to indicate, if the view should list directories.
[protected virtual]
this function is called after the class found out the correct index. The derived view must implement this function to add the file in the widget.
it's important, that the view keeps it's contents consistent with the indicies in the sorted list of the base class
[protected]
this function does the actual sorting. It is called by addItem and calls itself insertItem
[protected]
Increasing means greater indicies means bigger values
Decrease means greater indicies means smaller values
Switching means, that it should switch between Increasing and Decreasing
[protected]
set the sorting mode. Default mode is Increasing
[protected virtual]
pure virtual function, that should be implemented to clear the view. At this moment the list is already empty
[protected virtual]
set the highlighted item to index. This function must be implemented by the view
[protected]
the pixmap for normal files
[protected]
the pixmap for locked files
[protected]
the pixmap for normal folders
[protected]
the pixmap for locked folders
[protected]
sets the value for the selected file and emits the correct signal (depending on the type of the entry)
[protected]
gets the entry at index and calls the other select function with it
[protected]
returns, if the view is using single click to activate directories Note, that some views do not work completly with single click
[protected]
returns true, if the file at the specific position is a directory
[protected]
returns the complete file information for the file at the position index
[protected]
compares two items in the current context (sortMode and others) returns -1, if i1 is before i2 and 1, if the other case is true in case, both are equal (in current context), the behaviour is undefined!
[protected]
this is a help function for sorting, since I can't use the libc version (because I have a variable sort function)
I heard, STL has a qsort function too, but I don't want to use STL now
[private]
filled for completion
[private]
For internal use only.
class to distribute the signals
[private]
For internal use only.
adds an item to sortedArray
[private]
For internal use only.
finds the correct position in sortedArray @returns the found index
| Kdoc |