You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
453 lines
14 KiB
453 lines
14 KiB
/***************************************************************************
|
|
* Copyright (C) 2006 by Peter Penz <peter.penz@gmx.at> *
|
|
* Copyright (C) 2006 by Gregor Kališnik <gregor@podnapisi.net> *
|
|
* *
|
|
* This program is free software; you can redistribute it and/or modify *
|
|
* it under the terms of the GNU General Public License as published by *
|
|
* the Free Software Foundation; either version 2 of the License, or *
|
|
* (at your option) any later version. *
|
|
* *
|
|
* This program is distributed in the hope that it will be useful, *
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of *
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
|
|
* GNU General Public License for more details. *
|
|
* *
|
|
* You should have received a copy of the GNU General Public License *
|
|
* along with this program; if not, write to the *
|
|
* Free Software Foundation, Inc., *
|
|
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. *
|
|
***************************************************************************/
|
|
|
|
|
|
#ifndef _DOLPHINVIEW_H_
|
|
#define _DOLPHINVIEW_H_
|
|
|
|
#include <qwidget.h>
|
|
#include <kparts/part.h>
|
|
#include <kfileitem.h>
|
|
#include <kfileiconview.h>
|
|
#include <kio/job.h>
|
|
#include <urlnavigator.h>
|
|
|
|
class QPainter;
|
|
class KURL;
|
|
class QLineEdit;
|
|
class URLNavigator;
|
|
class QTimer;
|
|
class QIconViewItem;
|
|
class QListViewItem;
|
|
class QVBoxLayout;
|
|
class KFileView;
|
|
class Dolphin;
|
|
class DolphinDirLister;
|
|
class DolphinStatusBar;
|
|
class DolphinIconsView;
|
|
class DolphinDetailsView;
|
|
class ViewProperties;
|
|
class QScrollView;
|
|
class KProgress;
|
|
class ItemEffectsManager;
|
|
class FilterBar;
|
|
/**
|
|
* @short Represents a view for the directory content
|
|
* including the navigation bar and status bar.
|
|
*
|
|
* View modes for icons, details and previews are supported. Currently
|
|
* Dolphin allows to have up to two views inside the main window.
|
|
*
|
|
* @see DolphinIconsView
|
|
* @see DolphinDetailsView
|
|
* @see URLNavigator
|
|
* @see DolphinStatusBar
|
|
*
|
|
* @author Peter Penz <peter.penz@gmx.at>
|
|
*/
|
|
class DolphinView : public QWidget
|
|
{
|
|
Q_OBJECT
|
|
|
|
public:
|
|
/**
|
|
* Defines the view mode for a directory. The view mode
|
|
* can be defined when constructing a DolphinView. The
|
|
* view mode is automatically updated if the directory itself
|
|
* defines a view mode (see class ViewProperties for details).
|
|
*/
|
|
enum Mode
|
|
{
|
|
/**
|
|
* The directory items are shown as icons including an
|
|
* icon name. */
|
|
IconsView = 0,
|
|
|
|
/**
|
|
* The icon, the name and at least the size of the directory
|
|
* items are shown in a table. It is possible to add columns
|
|
* for date, group and permissions.
|
|
*/
|
|
DetailsView = 1,
|
|
|
|
/**
|
|
* The directory items are shown as preview if possible. As
|
|
* fallback the items are shown as icons.
|
|
*/
|
|
PreviewsView = 2
|
|
};
|
|
|
|
/** Defines the sort order for the items of a directory. */
|
|
enum Sorting
|
|
{
|
|
SortByName = 0,
|
|
SortBySize = 1,
|
|
SortByDate = 2
|
|
};
|
|
|
|
DolphinView(QWidget* parent,
|
|
const KURL& url,
|
|
Mode mode = IconsView,
|
|
bool showHiddenFiles = false);
|
|
|
|
virtual ~DolphinView();
|
|
|
|
/**
|
|
* Sets the current active URL.
|
|
* The signals URLNavigator::urlChanged and URLNavigator::historyChanged
|
|
* are submitted.
|
|
*/
|
|
void setURL(const KURL& url);
|
|
|
|
/** Returns the current active URL. */
|
|
const KURL& url() const;
|
|
|
|
void requestActivation();
|
|
bool isActive() const;
|
|
|
|
void setMode(Mode mode);
|
|
Mode mode() const;
|
|
void setShowHiddenFilesEnabled(bool show);
|
|
bool isShowHiddenFilesEnabled() const;
|
|
|
|
void setViewProperties(const ViewProperties& props);
|
|
|
|
/**
|
|
* Triggers the renaming of the currently selected items, where
|
|
* the user must input a new name for the items.
|
|
*/
|
|
void renameSelectedItems();
|
|
|
|
/**
|
|
* Selects all items.
|
|
* @see DolphinView::selectedItems()
|
|
*/
|
|
void selectAll();
|
|
|
|
/**
|
|
* Inverts the current selection: selected items get unselected,
|
|
* unselected items get selected.
|
|
* @see DolphinView::selectedItems()
|
|
*/
|
|
void invertSelection();
|
|
|
|
/**
|
|
* Goes back one step in the URL history. The signals
|
|
* URLNavigator::urlChanged and URLNavigator::historyChanged
|
|
* are submitted.
|
|
*/
|
|
void goBack();
|
|
|
|
/**
|
|
* Goes forward one step in the URL history. The signals
|
|
* URLNavigator::urlChanged and URLNavigator::historyChanged
|
|
* are submitted.
|
|
*/
|
|
void goForward();
|
|
|
|
/**
|
|
* Goes up one step of the URL path. The signals
|
|
* URLNavigator::urlChanged and URLNavigator::historyChanged
|
|
* are submitted.
|
|
*/
|
|
void goUp();
|
|
|
|
/**
|
|
* Goes to the home URL. The signals URLNavigator::urlChanged
|
|
* and URLNavigator::historyChanged are submitted.
|
|
*/
|
|
void goHome();
|
|
|
|
/**
|
|
* Sets the URL of the navigation bar to an editable state
|
|
* if \a editable is true. If \a editable is false, each part of
|
|
* the location is presented by a button for a fast navigation.
|
|
*/
|
|
void setURLEditable(bool editable);
|
|
|
|
/**
|
|
* Allows to edit the URL of the navigation bar and assures that
|
|
* the focus is assigned to the URL editor.
|
|
*/
|
|
void editURL();
|
|
|
|
/**
|
|
* Returns the complete URL history. The index 0 indicates the oldest
|
|
* history element.
|
|
* @param index Output parameter which indicates the current
|
|
* index of the location.
|
|
*/
|
|
const QValueList<URLNavigator::HistoryElem> urlHistory(int& index) const;
|
|
|
|
/**
|
|
* Returns true, if at least one item is selected.
|
|
*/
|
|
bool hasSelection() const;
|
|
|
|
/**
|
|
* Returns the selected items. 0 is returned, if no item
|
|
* is selected.
|
|
* @see DolphinView::selectedURLs()
|
|
*/
|
|
const KFileItemList* selectedItems() const;
|
|
|
|
/**
|
|
* Returns a list of URLs for all selected items. An empty list
|
|
* is returned, if no item is selected.
|
|
* @see DolphinView::selectedItems()
|
|
*/
|
|
KURL::List selectedURLs() const;
|
|
|
|
/**
|
|
* Returns the current item, where the cursor is. 0 is returned, if there is no
|
|
* current item (e. g. if the view is empty). Note that the current item must
|
|
* not be a selected item.
|
|
* @see DolphinView::selectedItems()
|
|
*/
|
|
const KFileItem* currentFileItem() const;
|
|
|
|
/**
|
|
* Opens the context menu for the item indicated by \a fileInfo
|
|
* on the position \a pos. If 0 is passed for the file info, a context
|
|
* menu for the viewport is opened.
|
|
*/
|
|
void openContextMenu(KFileItem* fileInfo, const QPoint& pos);
|
|
|
|
/**
|
|
* Renames the filename of the source URL by the new file name.
|
|
* If the new file name already exists, a dialog is opened which
|
|
* asks the user to enter a new name.
|
|
*/
|
|
void rename(const KURL& source, const QString& newName);
|
|
|
|
/** Returns the status bar of the view. */
|
|
DolphinStatusBar* statusBar() const;
|
|
|
|
/**
|
|
* Returns the x-position of the view content.
|
|
* The content of the view might be larger than the visible area
|
|
* and hence a scrolling must be done.
|
|
*/
|
|
int contentsX() const;
|
|
|
|
/**
|
|
* Returns the y-position of the view content.
|
|
* The content of the view might be larger than the visible area
|
|
* and hence a scrolling must be done.
|
|
*/
|
|
int contentsY() const;
|
|
|
|
/**
|
|
* Returns true, if the URL shown by the navigation bar is editable.
|
|
* @see URLNavigator
|
|
*/
|
|
bool isURLEditable() const;
|
|
|
|
/** Increases the size of the current set view mode. */
|
|
void zoomIn();
|
|
|
|
/** Decreases the size of the current set view mode. */
|
|
void zoomOut();
|
|
|
|
/**
|
|
* Returns true, if zooming in is possible. If false is returned,
|
|
* the minimal zoom size is possible.
|
|
*/
|
|
bool isZoomInPossible() const;
|
|
|
|
/**
|
|
* Returns true, if zooming out is possible. If false is returned,
|
|
* the maximum zoom size is possible.
|
|
*/
|
|
bool isZoomOutPossible() const;
|
|
|
|
/** Sets the sort order of the items inside a directory (see DolphinView::Sorting). */
|
|
void setSorting(Sorting sorting);
|
|
|
|
/** Returns the sort order of the items inside a directory (see DolphinView::Sorting). */
|
|
Sorting sorting() const;
|
|
|
|
/** Sets the sort order (Qt::Ascending or Qt::Descending) for the items. */
|
|
void setSortOrder(Qt::SortOrder order);
|
|
|
|
/** Returns the current used sort order (Qt::Ascending or Qt::Descending). */
|
|
Qt::SortOrder sortOrder() const;
|
|
|
|
/** Refreshs the view settings by reading out the stored settings. */
|
|
void refreshSettings();
|
|
|
|
/**
|
|
* Updates the number of items (= number of files + number of
|
|
* directories) in the statusbar. If files are selected, the number
|
|
* of selected files and the sum of the filesize is shown.
|
|
*/
|
|
void updateStatusBar();
|
|
|
|
/** Returns the URLNavigator of the view for read access. */
|
|
const URLNavigator* urlNavigator() const { return m_urlNavigator; }
|
|
|
|
/**
|
|
* Triggers to request user information for the item given
|
|
* by the URL \a url. The signal signalRequestItemInfo is emitted,
|
|
* which provides a way for widgets to get an indication to update
|
|
* the item information.
|
|
*/
|
|
void requestItemInfo(const KURL& url);
|
|
|
|
/**
|
|
* Checks if the filter bar is visible.
|
|
*
|
|
* @return @c true Filter bar is visible.
|
|
* @return @c false Filter bar is not visible.
|
|
*/
|
|
bool isFilterBarVisible() const;
|
|
|
|
public slots:
|
|
void reload();
|
|
void slotURLListDropped(QDropEvent* event,
|
|
const KURL::List& urls,
|
|
const KURL& url);
|
|
|
|
/**
|
|
* Slot that popups the filter bar like FireFox popups his Search bar.
|
|
*/
|
|
void slotShowFilterBar(bool show);
|
|
|
|
signals:
|
|
/** Is emitted if URL of the view has been changed to \a url. */
|
|
void signalURLChanged(const KURL& url);
|
|
|
|
/**
|
|
* Is emitted if the view mode (IconsView, DetailsView,
|
|
* PreviewsView) has been changed.
|
|
*/
|
|
void signalModeChanged();
|
|
|
|
/** Is emitted if the 'show hidden files' property has been changed. */
|
|
void signalShowHiddenFilesChanged();
|
|
|
|
/** Is emitted if the sorting by name, size or date has been changed. */
|
|
void signalSortingChanged(DolphinView::Sorting sorting);
|
|
|
|
/** Is emitted if the sort order (ascending or descending) has been changed. */
|
|
void signalSortOrderChanged(Qt::SortOrder order);
|
|
|
|
/**
|
|
* Is emitted if information of an item is requested to be shown e. g. in the sidebar.
|
|
* It the URL is empty, no item information request is pending.
|
|
*/
|
|
void signalRequestItemInfo(const KURL& url);
|
|
|
|
/** Is emitted if the contents has been moved to \a x, \a y. */
|
|
void contentsMoved(int x, int y);
|
|
|
|
/**
|
|
* Is emitted whenever the selection has been changed. The current selection can
|
|
* be retrieved by Dolphin::mainWin().activeView()->selectedItems() or by
|
|
* Dolphin::mainWin().activeView()->selectedURLs().
|
|
*/
|
|
void signalSelectionChanged();
|
|
|
|
protected:
|
|
/** @see QWidget::mouseReleaseEvent */
|
|
virtual void mouseReleaseEvent(QMouseEvent* event);
|
|
|
|
private slots:
|
|
void slotURLChanged(const KURL& kurl);
|
|
void triggerIconsViewItem(QIconViewItem *item);
|
|
void triggerDetailsViewItem(QListViewItem* item,
|
|
const QPoint& pos,
|
|
int column);
|
|
void triggerDetailsViewItem(QListViewItem* item);
|
|
void updateURL();
|
|
|
|
void slotPercent(int percent);
|
|
void slotClear();
|
|
void slotDeleteItem(KFileItem* item);
|
|
void slotCompleted();
|
|
void slotDelayedUpdate();
|
|
void slotInfoMessage(const QString& msg);
|
|
void slotErrorMessage(const QString& msg);
|
|
void slotRefreshItems(const KFileItemList& list);
|
|
void slotAddItems(const KFileItemList& list);
|
|
|
|
void slotGrabActivation();
|
|
|
|
/**
|
|
* Is invoked shortly before the contents of a view implementation
|
|
* has been moved and emits the signal contentsMoved. Note that no
|
|
* signal is emitted when the contents moving is only temporary by
|
|
* e. g. reloading a directory.
|
|
*/
|
|
void slotContentsMoving(int x, int y);
|
|
|
|
/**
|
|
* Filters the currently shown items by \a nameFilter. All items
|
|
* which contain the given filter string will be shown.
|
|
*/
|
|
void slotChangeNameFilter(const QString& nameFilter);
|
|
|
|
private:
|
|
void createView();
|
|
KFileView* fileView() const;
|
|
QScrollView* scrollView() const;
|
|
ItemEffectsManager* itemEffectsManager() const;
|
|
void startDirLister(const KURL& url, bool reload = false);
|
|
|
|
/**
|
|
* Returns the default text of the status bar, if no item is
|
|
* selected.
|
|
*/
|
|
QString defaultStatusBarText() const;
|
|
|
|
/**
|
|
* Returns the text for the status bar, if at least one item
|
|
* is selected.
|
|
*/
|
|
QString selectionStatusBarText() const;
|
|
|
|
/**
|
|
* Returns the string representation for the index \a index
|
|
* for renaming \itemCount items.
|
|
*/
|
|
QString renameIndexPresentation(int index, int itemCount) const;
|
|
|
|
bool m_refreshing;
|
|
bool m_showProgress;
|
|
Mode m_mode;
|
|
|
|
QVBoxLayout* m_topLayout;
|
|
URLNavigator* m_urlNavigator;
|
|
|
|
DolphinIconsView* m_iconsView;
|
|
DolphinDetailsView* m_detailsView;
|
|
DolphinStatusBar* m_statusBar;
|
|
|
|
int m_iconSize;
|
|
int m_folderCount;
|
|
int m_fileCount;
|
|
|
|
DolphinDirLister* m_dirLister;
|
|
|
|
FilterBar *m_filterBar;
|
|
};
|
|
|
|
#endif // _DOLPHINVIEW_H_
|