Diffstat (limited to 'libopie2/opieui/oversatileview.h') (more/less context) (show whitespace changes)
| -rw-r--r-- | libopie2/opieui/oversatileview.h | 394 |
1 files changed, 394 insertions, 0 deletions
diff --git a/libopie2/opieui/oversatileview.h b/libopie2/opieui/oversatileview.h new file mode 100644 index 0000000..1df8154 --- a/dev/null +++ b/libopie2/opieui/oversatileview.h @@ -0,0 +1,394 @@ +/* + This file is part of the Opie Project + + =. (C) 2003 Michael 'Mickey' Lauer <mickey@tm.informatik.uni-frankfurt.de> + .=l. + .>+-= + _;:, .> :=|. This program is free software; you can +.> <`_, > . <= redistribute it and/or modify it under +:`=1 )Y*s>-.-- : the terms of the GNU Library General Public +.="- .-=="i, .._ License as published by the Free Software + - . .-<_> .<> Foundation; either version 2 of the License, + ._= =} : or (at your option) any later version. + .%`+i> _;_. + .i_,=:_. -<s. 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 +..}^=.= = ; Library General Public License for more +++= -. .` .: details. + : = ...= . :.=- + -. .:....=;==+<; You should have received a copy of the GNU + -_. . . )=. = Library General Public License along with + -- :-=` this library; see the file COPYING.LIB. + If not, write to the Free Software Foundation, + Inc., 59 Temple Place - Suite 330, + Boston, MA 02111-1307, USA. + +*/ + +#ifndef OVERSATILEVIEW_H +#define OVERSATILEVIEW_H + +/* QT */ + +#include <qwidgetstack.h> +#include <qiconview.h> + +/* OPIE */ + +#include <qpe/qpeapplication.h> + +/* FORWARDS */ + +class QHeader; +class QIconSet; +class QIconViewItem; +class OListView; +class QListViewItem; +class QPopupMenu; +class QString; + +#ifndef QT_NO_DRAGANDDROP +class QIconDragItem; +#endif + +class OVersatileView : public QWidgetStack +{ + Q_OBJECT + + friend class OVersatileViewItem; + + //==============================================================================================// + // OVersatileView High Level API + //==============================================================================================// + + public: + OVersatileView( QWidget* parent = 0, const char* name = 0, int mode = 0 ); + ~OVersatileView(); + + QPopupMenu* contextMenu() const; + + void setSynchronization( bool sync ); + bool synchronization(); + + enum ViewMode { Tree = 0, Icons }; + int viewMode(); + + QIconView* iconView() const; + OListView* listView() const; + + enum WarningPolicy { None = 0, Warn, WarnReturn }; + + void setWarningPolicy( int ) const; // warn, if calling a method which doesn't apply to the current viewmode + bool warningPolicy() const; + + void setDefaultPixmaps( int mode, QPixmap& leaf, QPixmap& opened, QPixmap& closed ); + + public slots: + void setViewMode( int mode ); + void setIconViewMode(); + void setTreeViewMode(); + + protected: + virtual bool isValidViewMode( int mode ) const; + virtual void popupContextMenu( OVersatileViewItem* item, const QPoint& pos, int col = 0 ); + + private: + int _viewmode; + bool _synchronization; + mutable int _warningpolicy; + + OListView* _listview; + QIconView* _iconview; + + QPixmap _treeleaf; + QPixmap _treeopened; + QPixmap _treeclosed; + + QPixmap _iconleaf; + QPixmap _iconopened; + QPixmap _iconclosed; + + QPopupMenu* _contextmenu; + + int _iconstyle; + int _treestyle; + + private slots: + + void contextMenuRequested( QListViewItem*, const QPoint&, int ); + void contextMenuRequested( QIconViewItem*, const QPoint& ); + + // type converting signal forwarders + + void selectionChanged( QListViewItem * ); + void currentChanged( QListViewItem * ); + void clicked( QListViewItem * ); + void pressed( QListViewItem * ); + void doubleClicked( QListViewItem * ); + void returnPressed( QListViewItem * ); + void onItem( QListViewItem * ); + + void selectionChanged( QIconViewItem * ); + void currentChanged( QIconViewItem * ); + void clicked( QIconViewItem * ); + void pressed( QIconViewItem * ); + void doubleClicked( QIconViewItem * ); + void returnPressed( QIconViewItem * ); + void onItem( QIconViewItem * ); + + void expanded( QListViewItem * item ); // QListView + void collapsed( QListViewItem * item ); // QListView + + signals: + + void contextMenuRequested( OVersatileViewItem * item, const QPoint& pos, int col ); + + /*#ifndef QT_NO_DRAGANDDROP + void dropped( QDropEvent *e, const QValueList<QIconDragItem> &lst ); // QIconView + #endif + void itemRenamed( OVersatileViewItem *item, const QString & ); // QIconView + void itemRenamed( OVersatileViewItem *item ); // QIconView + */ + + //==============================================================================================// + // "Derived" API - Case 1: Methods existing either only in QListView or only in QIconView + //==============================================================================================// + +public: + + /* + enum Arrangement { // QIconView + LeftToRight = 0, + TopToBottom + }; + enum ResizeMode { // QIconView + Fixed = 0, + Adjust + }; + enum ItemTextPos { // QIconView + Bottom = 0, + Right + }; + */ + + // + // only in QListView + // + + int treeStepSize() const; // QListView + virtual void setTreeStepSize( int ); // QListView + + QHeader * header() const; // QListView + + virtual int addColumn( const QString &label, int size = -1); // QListView + virtual int addColumn( const QIconSet& iconset, const QString &label, int size = -1); // QListView + void removeColumn( int index ); // #### make virtual in next major release! // QListView + virtual void setColumnText( int column, const QString &label ); // QListView + virtual void setColumnText( int column, const QIconSet& iconset, const QString &label ); // QListView + QString columnText( int column ) const; // QListView + virtual void setColumnWidth( int column, int width ); // QListView + int columnWidth( int column ) const; // QListView + enum WidthMode { Manual, Maximum }; // QListView + virtual void setColumnWidthMode( int column, WidthMode ); // QListView + WidthMode columnWidthMode( int column ) const; // QListView + int columns() const; // QListView + + virtual void setColumnAlignment( int, int ); // QListView + int columnAlignment( int ) const; // QListView + + OVersatileViewItem * itemAt( const QPoint & screenPos ) const; // QListView + QRect itemRect( const OVersatileViewItem * ) const; // QListView + int itemPos( const OVersatileViewItem * ); // QListView + + bool isSelected( const OVersatileViewItem * ) const; // QListView // also in QIconViewItem but not in QIconView *shrug* + + virtual void setMultiSelection( bool enable ); // QListView + bool isMultiSelection() const; // QListView + + OVersatileViewItem * selectedItem() const; // QListView + virtual void setOpen( OVersatileViewItem *, bool ); // QListView + bool isOpen( const OVersatileViewItem * ) const; // QListView + + OVersatileViewItem * firstChild() const; // QListView + int childCount() const; // QListView + + virtual void setAllColumnsShowFocus( bool ); // QListView + bool allColumnsShowFocus() const; // QListView + + virtual void setItemMargin( int ); // QListView + int itemMargin() const; // QListView + + virtual void setRootIsDecorated( bool ); // QListView + bool rootIsDecorated() const; // QListView + + void setShowSortIndicator( bool show ); // QListView + bool showSortIndicator() const; // QListView + + int index( const OVersatileViewItem *item ) const; // QIconView + + public slots: + void triggerUpdate(); // QListView + + signals: + void expanded( OVersatileViewItem *item ); // QListView + void collapsed( OVersatileViewItem *item ); // QListView + + // + // only in QIconView + // + + public: + uint count() const; // QIconView + + OVersatileViewItem *firstItem() const; // QIconView + OVersatileViewItem *lastItem() const; // QIconView + + OVersatileViewItem *findItem( const QPoint &pos ) const; // QIconView + OVersatileViewItem *findItem( const QString &text ) const; // QIconView + + OVersatileViewItem* findFirstVisibleItem( const QRect &r ) const; // QIconView + OVersatileViewItem* findLastVisibleItem( const QRect &r ) const; // QIconView + + virtual void setGridX( int rx ); // QIconView + virtual void setGridY( int ry ); // QIconView + int gridX() const; // QIconView + int gridY() const; // QIconView + virtual void setSpacing( int sp ); // QIconView + int spacing() const; // QIconView + virtual void setItemTextPos( QIconView::ItemTextPos pos ); // QIconView + QIconView::ItemTextPos itemTextPos() const; // QIconView + virtual void setItemTextBackground( const QBrush &b ); // QIconView + QBrush itemTextBackground() const; // QIconView + virtual void setArrangement( QIconView::Arrangement am ); // QIconView + QIconView::Arrangement arrangement() const; // QIconView + virtual void setResizeMode( QIconView::ResizeMode am ); // QIconView + QIconView::ResizeMode resizeMode() const; // QIconView + virtual void setMaxItemWidth( int w ); // QIconView + int maxItemWidth() const; // QIconView + virtual void setMaxItemTextLength( int w ); // QIconView + int maxItemTextLength() const; // QIconView + virtual void setAutoArrange( bool b ); // QIconView + bool autoArrange() const; // QIconView + virtual void setShowToolTips( bool b ); // QIconView + bool showToolTips() const; // QIconView + + bool sorting() const; // QIconView + bool sortDirection() const; // QIconView + + virtual void setItemsMovable( bool b ); // QIconView + bool itemsMovable() const; // QIconView + virtual void setWordWrapIconText( bool b ); // QIconView + bool wordWrapIconText() const; // QIconView + + public slots: + virtual void arrangeItemsInGrid( const QSize &grid, bool update = TRUE ); // QIconView + virtual void arrangeItemsInGrid( bool update = TRUE ); // QIconView + virtual void updateContents(); // QIconView + + signals: + /*#ifndef QT_NO_DRAGANDDROP + void dropped( QDropEvent *e, const QValueList<QIconDragItem> &lst ); // QIconView + #endif + */ + void moved(); // QIconView + void itemRenamed( OVersatileViewItem *item, const QString & ); // QIconView + void itemRenamed( OVersatileViewItem *item ); // QIconView + + //==============================================================================================// + // "Derived" API - Case 2: Methods existing in QListView and QIconView with the same signatures + //==============================================================================================// + + public: + enum SelectionMode { + Single = 0, + Multi, + Extended, + NoSelection + }; + + virtual void clear(); + + virtual void setFont( const QFont & ); + virtual void setPalette( const QPalette & ); + + virtual void takeItem( OVersatileViewItem * ); + + void setSelectionMode( SelectionMode mode ); + SelectionMode selectionMode() const; + + virtual void selectAll( bool select ); + virtual void clearSelection(); + virtual void invertSelection(); + + void ensureItemVisible( const OVersatileViewItem * ); + virtual void repaintItem( const OVersatileViewItem * ) const; + + virtual void setCurrentItem( OVersatileViewItem * ); + OVersatileViewItem * currentItem() const; + + // bool eventFilter( QObject * o, QEvent * ); // use QWidgetStack implementation + + // QSize minimumSizeHint() const; // use QWidgetStack implementation + // QSizePolicy sizePolicy() const; // use QWidgetStack implementation + // QSize sizeHint() const; // use QWidgetStack implementation + + signals: + void selectionChanged(); + void selectionChanged( OVersatileViewItem * ); + void currentChanged( OVersatileViewItem * ); + void clicked( OVersatileViewItem * ); + void pressed( OVersatileViewItem * ); + + void doubleClicked( OVersatileViewItem * ); + void returnPressed( OVersatileViewItem * ); + + void onItem( OVersatileViewItem * ); + void onViewport(); + + //==============================================================================================// + // "Derived" API - Case 2: Methods existing in QListView and QIconView with differing signatures + //==============================================================================================// + + /* + + public: + virtual void insertItem( OVersatileViewItem * ); // QListView + virtual void insertItem( OVersatileViewItem *item, OVersatileViewItem *after = 0L ); // QIconView + + virtual void setSelected( OVersatileViewItem *, bool ); // QListView + virtual void setSelected( OVersatileViewItem *item, bool s, bool cb = FALSE ); // QIconView + + virtual void setSorting( int column, bool increasing = TRUE ); // QListView + void setSorting( bool sort, bool ascending = TRUE ); // QIconView + + void sort(); // #### make virtual in next major release // QListView + virtual void sort( bool ascending = TRUE ); // QIconView + + */ + + signals: + void clicked( OVersatileViewItem *, const QPoint &, int ); // QListView + void clicked( OVersatileViewItem *, const QPoint & ); // QIconView + + void pressed( OVersatileViewItem *, const QPoint &, int ); // QListView + void pressed( OVersatileViewItem *, const QPoint & ); // QIconView + + void rightButtonClicked( OVersatileViewItem* item, const QPoint& pos ); // QIconView + void rightButtonClicked( OVersatileViewItem *, const QPoint&, int ); // QListView + + void rightButtonPressed( OVersatileViewItem* item, const QPoint& pos ); // QIconView + void rightButtonPressed( OVersatileViewItem *, const QPoint&, int ); // QListView + + void mouseButtonPressed( int, OVersatileViewItem *, const QPoint& , int ); // QListView + void mouseButtonPressed( int button, OVersatileViewItem* item, const QPoint& pos ); // QIconView + + void mouseButtonClicked( int, OVersatileViewItem *, const QPoint&, int ); // QListView + void mouseButtonClicked( int button, OVersatileViewItem* item, const QPoint& pos ); // QIconView + +}; + +#endif + |