org.kde.koala

Class KDirOperator

public class KDirOperator extends QWidget

This widget works as a network transparent filebrowser. You specify a URL to display and this url will be loaded via KDirLister. The user can browse through directories, highlight and select files, delete or rename files. It supports different views, e.g. a detailed view (see KFileDetailView), a simple icon view (see KFileIconView), a combination of two views, separating directories and files ( KCombiView). Additionally, a preview view is available (see KFilePreview), which can show either a simple or detailed view and additionally a preview widget (see setPreviewWidget()). KImageFilePreview is one implementation of a preview widget, that displays previews for all supported filetypes utilizing KIO.PreviewJob. 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 Bjo?=n Sahlstro?= until they will be integrated into this library. See http://devel-home.kde.org/~pfeiffer/DnD-classes.tar.gz This widget is the one used in the KFileDialog. Basic usage is like this:
   KDirOperator op = new KDirOperator( KURL( "file:/home/gis" ), this );
   // some signals you might be interested in
   connect(op, SIGNAL("urlEntered(KURL)"),
           SLOT("urlEntered(KURL)"));
   connect(op, SIGNAL("fileHighlighted(const KFileItem )"),
           SLOT("fileHighlighted(const KFileItem )"));
   connect(op, SIGNAL("fileSelected(const KFileItem )"),
           SLOT("fileSelected(const KFileItem )"));
   connect(op, SIGNAL("finishedLoading()"),
           SLOT("slotLoadingFinished()"));
   op.readConfig( KGlobal.config(), "Your KDiroperator ConfigGroup" );
   op.setView(KFile.Default);
 
This will create a childwidget of 'this' showing the directory contents of /home/gis in the default-view. The view is determined by the readConfig() call, which will read the KDirOperator settings, the user left your program with (and which you saved with op.writeConfig()). See KDirOperatorSignals for signals emitted by KDirOperator

Author: Stephan Kulow , Carsten Pfeiffer

UNKNOWN: A widget for displaying files and browsing directories.

Field Summary
static intAllActions
static intFileActions
static intNavActions
static intSortActions
The various action types.
static intViewActions
Constructor Summary
protected KDirOperator(Class dummy)
KDirOperator(KURL urlName, QWidget parent, String name)
Constructs the KDirOperator with no initial view.
KDirOperator(KURL urlName, QWidget parent)
KDirOperator(KURL urlName)
KDirOperator()
Method Summary
KActionCollectionactionCollection()
an accessor to a collection of all available Actions.
protected voidactivatedMenu(KFileItem arg1, QPoint pos)
Called upon right-click to activate the popupmenu.
voidback()
Goes one step back in the history and opens that url.
voidcdUp()
Goes one directory up from the current url.
protected booleancheckPreviewSupport()
Checks if there support from KIO.PreviewJob for the currently shown files, taking mimeFilter() and nameFilter() into account Enables/disables the preview-action accordingly.
StringclassName()
voidclearFilter()
Clears both the namefilter and mimetype filter, so that all files and directories will be shown.
voidclearHistory()
Clears the forward and backward history.
booleanclose(boolean alsoDelete)
voidcloseLoading()
Stops loading immediately.
KCompletioncompletionObject()
protected KFileViewInterfacecreateView(QWidget parent, int view)
A view factory for creating predefined fileviews.
DeleteJobdel(ArrayList items, boolean ask, boolean showProgress)
Starts and returns a KIO.DeleteJob to delete the given items.
DeleteJobdel(ArrayList items, boolean ask)
DeleteJobdel(ArrayList items)
DeleteJobdel(ArrayList items, QWidget parent, boolean ask, boolean showProgress)
Starts and returns a KIO.DeleteJob to delete the given items.
DeleteJobdel(ArrayList items, QWidget parent, boolean ask)
DeleteJobdel(ArrayList items, QWidget parent)
voiddeleteSelected()
Deletes the currently selected files/directories.
KCompletiondirCompletionObject()
booleandirHighlighting()
Default is false.
KDirListerdirLister()
booleandirOnlyMode()
static booleandirOnlyMode(int mode)
voiddispose()
Delete the wrapped C++ instance ahead of finalize()
protected voidfinalize()
Deletes the wrapped C++ instance
voidforward()
Goes one step forward in the history and opens that url.
protected voidhighlightFile(KFileItem i)
Emits fileHighlighted( i )
voidhome()
Enters the home directory.
protected voidinsertNewFiles(ArrayList newone)
Adds a new list of KFileItems to the view (coming from KDirLister)
booleanisDisposed()
Has the wrapped C++ instance been deleted?
booleanisRoot()
booleanisSelected(KFileItem item)
protected voiditemDeleted(KFileItem arg1)
Removes the given KFileItem item from the view (usually called from KDirLister).
StringmakeCompletion(String arg1)
Tries to complete the given string (only completes files).
StringmakeDirCompletion(String arg1)
Tries to complete the given string (only completes directores).
QMetaObjectmetaObject()
ArrayListmimeFilter()
booleanmkdir(String directory, boolean enterDirectory)
Creates the given directory/url.
booleanmkdir(String directory)
voidmkdir()
Opens a dialog to create a new directory.
intmode()
StringnameFilter()
intnumDirs()
intnumFiles()
booleanonlyDoubleClickSelectsFiles()
protected voidpathChanged()
Called after setURL() to load the directory, update the history, etc.
protected voidprepareCompletionObjects()
Synchronizes the completion objects with the entries of the currently listed url.
KProgressprogressBar()
voidreadConfig(KConfig arg1, String group)
Reads the default settings for a view, i.e. the default KFile.FileView.
voidreadConfig(KConfig arg1)
voidrereadDir()
Re-reads the current url.
protected voidresetCursor()
Restores the normal cursor after showing the busy-cursor.
protected voidresizeEvent(QResizeEvent arg1)
protected voidselectDir(KFileItem item)
Enters the directory specified by the given item.
ArrayListselectedItems()
protected voidselectFile(KFileItem item)
Emits fileSelected( item )
voidsetAcceptDrops(boolean b)
Reimplemented - allow dropping of files if b is true
voidsetCurrentItem(String filename)
Clears the current selection and attempts to set filename the current file. filename is just the name, no path or url.
protected voidsetDirLister(KDirLister lister)
Sets a custom KDirLister to list directories.
voidsetDropOptions(int options)
Sets the options for dropping files.
voidsetEnableDirHighlighting(boolean enable)
When going up in the directory hierarchy, KDirOperator can highlight the directory that was just left.
voidsetMimeFilter(String[] mimetypes)
Sets a list of mimetypes as filter.
voidsetMode(int m)
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, as the former means single-selection mode, the latter multi-selection.
    voidsetNameFilter(String filter)
    Sets a filter like "*.cpp .h .o".
    voidsetOnlyDoubleClickSelectsFiles(boolean enable)
    This is a KFileDialog specific hack: we want to select directories with single click, but not files.
    voidsetPreviewWidget(QWidget w)
    Sets a preview-widget to be shown next to the file-view.
    voidsetShowHiddenFiles(boolean s)
    Enables/disables showing hidden files.
    voidsetSorting(int arg1)
    Sets the way to sort files and directories.
    protected voidsetupActions()
    Sets up all the actions.
    voidsetupMenu(int whichActions)
    Sets up the action menu.
    protected voidsetupMenu()
    Sets up the context-menu with all the necessary actions.
    voidsetURL(KURL url, boolean clearforward)
    Sets a new url to list.
    voidsetView(KFileViewInterface view)
    Sets a new KFileView to be used for showing and browsing files.
    voidsetView(int view)
    Sets one of the predefined fileviews
    voidsetViewConfig(KConfig config, String group)
    Sets the config object and the to be used group in KDirOperator.
    booleanshowHiddenFiles()
    protected voidslotCompletionMatch(String match)
    Tries to make the given match as current item in the view and emits completion( match )
    protected voidsortByDate()
    Changes sorting to sort by date
    protected voidsortByName()
    Changes sorting to sort by name
    protected voidsortBySize()
    Changes sorting to sort by size
    intsorting()
    protected voidsortReversed()
    Changes sorting to reverse sorting
    protected voidtoggleDirsFirst()
    Toggles showing directories first / having them sorted like files.
    protected voidtoggleIgnoreCase()
    Toggles case sensitive / case insensitive sorting
    CopyJobtrash(ArrayList items, QWidget parent, boolean ask, boolean showProgress)
    Starts and returns a KIO.CopyJob to trash the given items.
    CopyJobtrash(ArrayList items, QWidget parent, boolean ask)
    CopyJobtrash(ArrayList items, QWidget parent)
    voidtrashSelected(int arg1, int arg2)
    Trashes the currently selected files/directories.
    voidupdateDir()
    to update the view after changing the settings
    voidupdateSelectionDependentActions()
    Enables/disables actions that are selection dependent.
    protected voidupdateSortActions()
    Updates the sorting-related actions to comply with the current sorting
    protected voidupdateViewActions()
    Updates the view-related actions to comply with the current KFile.FileView
    KURLurl()
    KFileViewInterfaceview()
    KConfigviewConfig()
    Returns the KConfig object used for saving and restoring view's configuration.
    StringviewConfigGroup()
    Returns the group name used for saving and restoring view's configuration.
    QWidgetviewWidget()
    Returns the widget of the current view. null if there is no view/widget.
    voidwriteConfig(KConfig arg1, String group)
    Saves the current settings like sorting, simple or detailed view.
    voidwriteConfig(KConfig arg1)

    Field Detail

    AllActions

    public static final int AllActions

    FileActions

    public static final int FileActions

    NavActions

    public static final int NavActions

    SortActions

    public static final int SortActions
    The various action types. These values can be or'd together

    UNKNOWN: The various action types.

    ViewActions

    public static final int ViewActions

    Constructor Detail

    KDirOperator

    protected KDirOperator(Class dummy)

    KDirOperator

    public KDirOperator(KURL urlName, QWidget parent, String name)
    Constructs the KDirOperator with no initial view. As the views are configurable, call readConfig() to load the user's configuration and then setView to explicitly set a view. This constructor doesn't start loading the url, setView will do it.

    UNKNOWN: Constructs the KDirOperator with no initial view.

    KDirOperator

    public KDirOperator(KURL urlName, QWidget parent)

    KDirOperator

    public KDirOperator(KURL urlName)

    KDirOperator

    public KDirOperator()

    Method Detail

    actionCollection

    public KActionCollection actionCollection()
    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
  • delete : deletes the selected files/directories
  • 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
  • preview : shows a preview next to the fileview
  • single : hides the separate view for directories or the preview
  • properties : shows a KPropertiesDialog for the selected files
  • 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. You can e.g. use
    		 actionCollection().action( "up" ).plug( someToolBar );
    		 
    to add a button into a toolbar, which makes the dirOperator change to its parent directory.

    Returns: all available Actions

    UNKNOWN: an accessor to a collection of all available Actions.

    activatedMenu

    protected void activatedMenu(KFileItem arg1, QPoint pos)
    Called upon right-click to activate the popupmenu.

    UNKNOWN: Called upon right-click to activate the popupmenu.

    back

    public void back()
    Goes one step back in the history and opens that url.

    UNKNOWN: Goes one step back in the history and opens that url.

    cdUp

    public void cdUp()
    Goes one directory up from the current url.

    UNKNOWN: Goes one directory up from the current url.

    checkPreviewSupport

    protected boolean checkPreviewSupport()
    Checks if there support from KIO.PreviewJob for the currently shown files, taking mimeFilter() and nameFilter() into account Enables/disables the preview-action accordingly.

    UNKNOWN: Checks if there support from KIO.PreviewJob for the currently shown files, taking mimeFilter() and nameFilter() into account Enables/disables the preview-action accordingly.

    className

    public String className()

    clearFilter

    public void clearFilter()
    Clears both the namefilter and mimetype filter, so that all files and directories will be shown. Call updateDir() to apply it.

    See Also: KDirOperator KDirOperator

    UNKNOWN: Clears both the namefilter and mimetype filter, so that all files and directories will be shown.

    clearHistory

    public void clearHistory()
    Clears the forward and backward history.

    UNKNOWN: Clears the forward and backward history.

    close

    public boolean close(boolean alsoDelete)

    closeLoading

    public void closeLoading()
    Stops loading immediately. You don't need to call this, usually.

    UNKNOWN: Stops loading immediately.

    completionObject

    public KCompletion completionObject()

    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()

    UNKNOWN:

    createView

    protected KFileViewInterface createView(QWidget parent, int view)
    A view factory for creating predefined fileviews. Called internally by setView , but you can also call it directly. Reimplement this if you depend on self defined fileviews.

    Parameters: parent is the QWidget to be set as parent view is the predefined view to be set, note: this can be several ones OR:ed together.

    Returns: the created KFileView

    See Also: KFileView KCombiView KFileDetailView KFileIconView KFilePreview KFile KDirOperator

    UNKNOWN: A view factory for creating predefined fileviews.

    del

    public DeleteJob del(ArrayList items, boolean ask, boolean showProgress)
    Starts and returns a KIO.DeleteJob to delete the given items.

    Parameters: items the list of items to be deleted ask specifies whether a confirmation dialog should be shown showProgress passed to the DeleteJob to show a progress dialog

    UNKNOWN: Starts and returns a KIO.DeleteJob to delete the given items.

    del

    public DeleteJob del(ArrayList items, boolean ask)

    del

    public DeleteJob del(ArrayList items)

    del

    public DeleteJob del(ArrayList items, QWidget parent, boolean ask, boolean showProgress)
    Starts and returns a KIO.DeleteJob to delete the given items.

    Parameters: items the list of items to be deleted parent the parent widget used for the confirmation dialog ask specifies whether a confirmation dialog should be shown showProgress passed to the DeleteJob to show a progress dialog

    UNKNOWN: Starts and returns a KIO.DeleteJob to delete the given items.

    del

    public DeleteJob del(ArrayList items, QWidget parent, boolean ask)

    del

    public DeleteJob del(ArrayList items, QWidget parent)

    deleteSelected

    public void deleteSelected()
    Deletes the currently selected files/directories.

    UNKNOWN: Deletes the currently selected files/directories.

    dirCompletionObject

    public KCompletion dirCompletionObject()

    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()

    UNKNOWN:

    dirHighlighting

    public boolean dirHighlighting()
    Default is false.

    Returns: whether the last directory will be made the current item when going up in the directory hierarchy.

    UNKNOWN:

    dirLister

    public KDirLister dirLister()

    Returns: the object listing the directory

    UNKNOWN:

    dirOnlyMode

    public boolean dirOnlyMode()

    Returns: true if we are in directory-only mode, that is, no files are shown.

    UNKNOWN:

    dirOnlyMode

    public static boolean dirOnlyMode(int mode)

    dispose

    public void dispose()
    Delete the wrapped C++ instance ahead of finalize()

    finalize

    protected void finalize()
    Deletes the wrapped C++ instance

    forward

    public void forward()
    Goes one step forward in the history and opens that url.

    UNKNOWN: Goes one step forward in the history and opens that url.

    highlightFile

    protected void highlightFile(KFileItem i)
    Emits fileHighlighted( i )

    UNKNOWN: Emits fileHighlighted( i )

    home

    public void home()
    Enters the home directory.

    UNKNOWN: Enters the home directory.

    insertNewFiles

    protected void insertNewFiles(ArrayList newone)
    Adds a new list of KFileItems to the view (coming from KDirLister)

    UNKNOWN: Adds a new list of KFileItems to the view (coming from KDirLister)

    isDisposed

    public boolean isDisposed()
    Has the wrapped C++ instance been deleted?

    isRoot

    public boolean isRoot()

    Returns: true if we are displaying the root directory of the current url

    UNKNOWN:

    isSelected

    public boolean isSelected(KFileItem item)

    Returns: true if item is currently selected, or false otherwise.

    UNKNOWN:

    itemDeleted

    protected void itemDeleted(KFileItem arg1)
    Removes the given KFileItem item from the view (usually called from KDirLister).

    UNKNOWN: Removes the given KFileItem item from the view (usually called from KDirLister).

    makeCompletion

    public String makeCompletion(String arg1)
    Tries to complete the given string (only completes files).

    UNKNOWN: Tries to complete the given string (only completes files).

    makeDirCompletion

    public String makeDirCompletion(String arg1)
    Tries to complete the given string (only completes directores).

    UNKNOWN: Tries to complete the given string (only completes directores).

    metaObject

    public QMetaObject metaObject()

    mimeFilter

    public ArrayList mimeFilter()

    Returns: the current mime filter.

    UNKNOWN:

    mkdir

    public boolean mkdir(String directory, boolean enterDirectory)
    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.

    UNKNOWN: Creates the given directory/url.

    mkdir

    public boolean mkdir(String directory)

    mkdir

    public void mkdir()
    Opens a dialog to create a new directory.

    UNKNOWN: Opens a dialog to create a new directory.

    mode

    public int mode()

    Returns: the listing/selection mode.

    UNKNOWN:

    nameFilter

    public String nameFilter()

    Returns: the current namefilter.

    See Also: KDirOperator

    UNKNOWN:

    numDirs

    public int numDirs()

    Returns: the number of directories in the currently listed url. Returns 0 if there is no view.

    UNKNOWN:

    numFiles

    public int numFiles()

    Returns: the number of files in the currently listed url. Returns 0 if there is no view.

    UNKNOWN:

    onlyDoubleClickSelectsFiles

    public boolean onlyDoubleClickSelectsFiles()

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

    See Also: KDirOperator

    UNKNOWN:

    pathChanged

    protected void pathChanged()
    Called after setURL() to load the directory, update the history, etc.

    UNKNOWN: Called after setURL() to load the directory, update the history, etc.

    prepareCompletionObjects

    protected void prepareCompletionObjects()
    Synchronizes the completion objects with the entries of the currently listed url. Automatically called from makeCompletion() and makeDirCompletion()

    UNKNOWN: Synchronizes the completion objects with the entries of the currently listed url.

    progressBar

    public KProgress progressBar()

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

    UNKNOWN:

    readConfig

    public void readConfig(KConfig arg1, String group)
    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
    		 setView( KFile.Default )
    		 
    to apply it.

    See Also: KDirOperator KDirOperator KDirOperator

    UNKNOWN: Reads the default settings for a view, i.

    readConfig

    public void readConfig(KConfig arg1)

    rereadDir

    public void rereadDir()
    Re-reads the current url.

    UNKNOWN: Re-reads the current url.

    resetCursor

    protected void resetCursor()
    Restores the normal cursor after showing the busy-cursor. Also hides the progressbar.

    UNKNOWN: Restores the normal cursor after showing the busy-cursor.

    resizeEvent

    protected void resizeEvent(QResizeEvent arg1)

    selectDir

    protected void selectDir(KFileItem item)
    Enters the directory specified by the given item.

    UNKNOWN: Enters the directory specified by the given item.

    selectedItems

    public ArrayList selectedItems()

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

    UNKNOWN:

    selectFile

    protected void selectFile(KFileItem item)
    Emits fileSelected( item )

    UNKNOWN: Emits fileSelected( item )

    setAcceptDrops

    public void setAcceptDrops(boolean b)
    Reimplemented - allow dropping of files if b is true

    Parameters: b true if the widget should allow dropping of files

    UNKNOWN: Reimplemented - allow dropping of files if b is true

    setCurrentItem

    public void setCurrentItem(String filename)
    Clears the current selection and attempts to set filename the current file. filename is just the name, no path or url.

    UNKNOWN: Clears the current selection and attempts to set filename the current file.

    setDirLister

    protected void setDirLister(KDirLister lister)
    Sets a custom KDirLister to list directories.

    UNKNOWN: Sets a custom KDirLister to list directories.

    setDropOptions

    public void setDropOptions(int options)
    Sets the options for dropping files.

    See Also: KFileView

    UNKNOWN: Sets the options for dropping files.

    setEnableDirHighlighting

    public void setEnableDirHighlighting(boolean enable)
    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. Default is off.

    UNKNOWN: When going up in the directory hierarchy, KDirOperator can highlight the directory that was just left.

    setMimeFilter

    public void setMimeFilter(String[] mimetypes)
    Sets a list of mimetypes as filter. Only files of those mimetypes will be shown. Example:
    		 ArrayList filter;
    		 filter << "text/html" << "image/png" << "inode/directory";
    		 dirOperator.setMimefilter( filter );
    		 
    Node: Without the mimetype inode/directory, only files would be shown. Call updateDir() to apply it.

    See Also: KDirLister KDirOperator

    UNKNOWN: Sets a list of mimetypes as filter.

    setMode

    public void setMode(int m)
    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, as the former means single-selection mode, the latter multi-selection.

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

    setNameFilter

    public void setNameFilter(String filter)
    Sets a filter like "*.cpp .h .o". Only files matching that filter will be shown. Call updateDir() to apply it.

    See Also: KDirLister KDirOperator

    UNKNOWN: Sets a filter like " .

    setOnlyDoubleClickSelectsFiles

    public void setOnlyDoubleClickSelectsFiles(boolean enable)
    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.

    UNKNOWN: This is a KFileDialog specific hack: we want to select directories with single click, but not files.

    setPreviewWidget

    public void setPreviewWidget(QWidget w)
    Sets a preview-widget to be shown next to the file-view. The ownership of w is transferred to KDirOperator, so don't delete it yourself!

    UNKNOWN: Sets a preview-widget to be shown next to the file-view.

    setShowHiddenFiles

    public void setShowHiddenFiles(boolean s)
    Enables/disables showing hidden files.

    UNKNOWN: Enables/disables showing hidden files.

    setSorting

    public void setSorting(int arg1)
    Sets the way to sort files and directories.

    UNKNOWN: Sets the way to sort files and directories.

    setupActions

    protected void setupActions()
    Sets up all the actions. Called from the constructor, you usually better not call this.

    UNKNOWN: Sets up all the actions.

    setupMenu

    public void setupMenu(int whichActions)
    Sets up the action menu.

    Parameters: whichActions is an value of OR'd ActionTypes that controls which actions to show in the action menu

    UNKNOWN: Sets up the action menu.

    setupMenu

    protected void setupMenu()
    Sets up the context-menu with all the necessary actions. Called from the constructor, you usually don't need to call this.

    UNKNOWN: Sets up the context-menu with all the necessary actions.

    setURL

    public void setURL(KURL url, boolean clearforward)
    Sets a new url to list.

    Parameters: clearforward specifies whether the "forward" history should be cleared. url the URL to set

    UNKNOWN: Sets a new url to list.

    setView

    public void setView(KFileViewInterface view)
    Sets a new KFileView to be used for showing and browsing files. Note: this will read the current url() to fill the view.

    See Also: KFileView KFileIconView KFileDetailView KCombiView KDirOperator

    UNKNOWN: Sets a new KFileView to be used for showing and browsing files.

    setView

    public void setView(int view)
    Sets one of the predefined fileviews

    See Also: KFile

    UNKNOWN: Sets one of the predefined fileviews

    setViewConfig

    public void setViewConfig(KConfig config, String group)
    Sets the config object and the to be used group in KDirOperator. This will be used to store the view's configuration via KFileView.writeConfig() (and for KFileView.readConfig()). If you don't set this, the views cannot save and restore their configuration. Usually you call this right after KDirOperator creation so that the view instantiation can make use of it already. Note that KDirOperator does NOT take ownership of that object (typically it's KGlobal.config() anyway.

    See Also: KDirOperator KDirOperator

    UNKNOWN: Sets the config object and the to be used group in KDirOperator.

    showHiddenFiles

    public boolean showHiddenFiles()

    Returns: true when hidden files are shown or false otherwise.

    UNKNOWN:

    slotCompletionMatch

    protected void slotCompletionMatch(String match)
    Tries to make the given match as current item in the view and emits completion( match )

    UNKNOWN: Tries to make the given match as current item in the view and emits completion( match )

    sortByDate

    protected void sortByDate()
    Changes sorting to sort by date

    UNKNOWN: Changes sorting to sort by date

    sortByName

    protected void sortByName()
    Changes sorting to sort by name

    UNKNOWN: Changes sorting to sort by name

    sortBySize

    protected void sortBySize()
    Changes sorting to sort by size

    UNKNOWN: Changes sorting to sort by size

    sorting

    public int sorting()

    Returns: the current way of sorting files and directories

    UNKNOWN:

    sortReversed

    protected void sortReversed()
    Changes sorting to reverse sorting

    UNKNOWN: Changes sorting to reverse sorting

    toggleDirsFirst

    protected void toggleDirsFirst()
    Toggles showing directories first / having them sorted like files.

    UNKNOWN: Toggles showing directories first / having them sorted like files.

    toggleIgnoreCase

    protected void toggleIgnoreCase()
    Toggles case sensitive / case insensitive sorting

    UNKNOWN: Toggles case sensitive / case insensitive sorting

    trash

    public CopyJob trash(ArrayList items, QWidget parent, boolean ask, boolean showProgress)
    Starts and returns a KIO.CopyJob to trash the given items.

    Parameters: items the list of items to be trashed parent the parent widget used for the confirmation dialog ask specifies whether a confirmation dialog should be shown showProgress passed to the CopyJob to show a progress dialog

    UNKNOWN: Starts and returns a KIO.CopyJob to trash the given items.

    trash

    public CopyJob trash(ArrayList items, QWidget parent, boolean ask)

    trash

    public CopyJob trash(ArrayList items, QWidget parent)

    trashSelected

    public void trashSelected(int arg1, int arg2)
    Trashes the currently selected files/directories.

    UNKNOWN: Trashes the currently selected files/directories.

    updateDir

    public void updateDir()
    to update the view after changing the settings

    UNKNOWN: to update the view after changing the settings

    updateSelectionDependentActions

    public void updateSelectionDependentActions()
    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.

    UNKNOWN: Enables/disables actions that are selection dependent.

    updateSortActions

    protected void updateSortActions()
    Updates the sorting-related actions to comply with the current sorting

    See Also: KDirOperator

    UNKNOWN: Updates the sorting-related actions to comply with the current sorting

    updateViewActions

    protected void updateViewActions()
    Updates the view-related actions to comply with the current KFile.FileView

    UNKNOWN: Updates the view-related actions to comply with the current KFile.FileView

    url

    public KURL url()

    Returns: the current url

    UNKNOWN:

    view

    public KFileViewInterface view()

    Returns: the currently used view.

    See Also: KDirOperator

    UNKNOWN:

    viewConfig

    public KConfig viewConfig()
    Returns the KConfig object used for saving and restoring view's configuration.

    Returns: the KConfig object used for saving and restoring view's configuration.

    UNKNOWN: Returns the KConfig object used for saving and restoring view's configuration.

    viewConfigGroup

    public String viewConfigGroup()
    Returns the group name used for saving and restoring view's configuration.

    Returns: the group name used for saving and restoring view's configuration.

    UNKNOWN: Returns the group name used for saving and restoring view's configuration.

    viewWidget

    public QWidget viewWidget()
    Returns the widget of the current view. null if there is no view/widget. (KFileView itself is not a widget.)

    UNKNOWN: Returns the widget of the current view.

    writeConfig

    public void writeConfig(KConfig arg1, String group)
    Saves the current settings like sorting, simple or detailed view.

    See Also: KDirOperator KDirOperator

    UNKNOWN: Saves the current settings like sorting, simple or detailed view.

    writeConfig

    public void writeConfig(KConfig arg1)