/**************************************************************************** | |
** | |
** Copyright (C) 2011 Nokia Corporation and/or its subsidiary(-ies). | |
** All rights reserved. | |
** Contact: Nokia Corporation (qt-info@nokia.com) | |
** | |
** This file is part of the QtGui module of the Qt Toolkit. | |
** | |
** $QT_BEGIN_LICENSE:LGPL$ | |
** GNU Lesser General Public License Usage | |
** This file may be used under the terms of the GNU Lesser General Public | |
** License version 2.1 as published by the Free Software Foundation and | |
** appearing in the file LICENSE.LGPL included in the packaging of this | |
** file. Please review the following information to ensure the GNU Lesser | |
** General Public License version 2.1 requirements will be met: | |
** http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html. | |
** | |
** In addition, as a special exception, Nokia gives you certain additional | |
** rights. These rights are described in the Nokia Qt LGPL Exception | |
** version 1.1, included in the file LGPL_EXCEPTION.txt in this package. | |
** | |
** GNU General Public License Usage | |
** Alternatively, this file may be used under the terms of the GNU General | |
** Public License version 3.0 as published by the Free Software Foundation | |
** and appearing in the file LICENSE.GPL included in the packaging of this | |
** file. Please review the following information to ensure the GNU General | |
** Public License version 3.0 requirements will be met: | |
** http://www.gnu.org/copyleft/gpl.html. | |
** | |
** Other Usage | |
** Alternatively, this file may be used in accordance with the terms and | |
** conditions contained in a signed written agreement between you and Nokia. | |
** | |
** | |
** | |
** | |
** | |
** $QT_END_LICENSE$ | |
** | |
****************************************************************************/ | |
#ifndef QABSTRACTITEMVIEW_H | |
#define QABSTRACTITEMVIEW_H | |
#include <QtGui/qabstractscrollarea.h> | |
#include <QtCore/qabstractitemmodel.h> | |
#include <QtGui/qitemselectionmodel.h> | |
#include <QtGui/qabstractitemdelegate.h> | |
QT_BEGIN_HEADER | |
QT_BEGIN_NAMESPACE | |
QT_MODULE(Gui) | |
#ifndef QT_NO_ITEMVIEWS | |
class QMenu; | |
class QDrag; | |
class QEvent; | |
class QAbstractItemViewPrivate; | |
class Q_GUI_EXPORT QAbstractItemView : public QAbstractScrollArea | |
{ | |
Q_OBJECT | |
Q_ENUMS(SelectionMode SelectionBehavior ScrollHint ScrollMode DragDropMode) | |
Q_FLAGS(EditTriggers) | |
Q_PROPERTY(bool autoScroll READ hasAutoScroll WRITE setAutoScroll) | |
Q_PROPERTY(int autoScrollMargin READ autoScrollMargin WRITE setAutoScrollMargin) | |
Q_PROPERTY(EditTriggers editTriggers READ editTriggers WRITE setEditTriggers) | |
Q_PROPERTY(bool tabKeyNavigation READ tabKeyNavigation WRITE setTabKeyNavigation) | |
#ifndef QT_NO_DRAGANDDROP | |
Q_PROPERTY(bool showDropIndicator READ showDropIndicator WRITE setDropIndicatorShown) | |
Q_PROPERTY(bool dragEnabled READ dragEnabled WRITE setDragEnabled) | |
Q_PROPERTY(bool dragDropOverwriteMode READ dragDropOverwriteMode WRITE setDragDropOverwriteMode) | |
Q_PROPERTY(DragDropMode dragDropMode READ dragDropMode WRITE setDragDropMode) | |
Q_PROPERTY(Qt::DropAction defaultDropAction READ defaultDropAction WRITE setDefaultDropAction) | |
#endif | |
Q_PROPERTY(bool alternatingRowColors READ alternatingRowColors WRITE setAlternatingRowColors) | |
Q_PROPERTY(SelectionMode selectionMode READ selectionMode WRITE setSelectionMode) | |
Q_PROPERTY(SelectionBehavior selectionBehavior READ selectionBehavior WRITE setSelectionBehavior) | |
Q_PROPERTY(QSize iconSize READ iconSize WRITE setIconSize) | |
Q_PROPERTY(Qt::TextElideMode textElideMode READ textElideMode WRITE setTextElideMode) | |
Q_PROPERTY(ScrollMode verticalScrollMode READ verticalScrollMode WRITE setVerticalScrollMode) | |
Q_PROPERTY(ScrollMode horizontalScrollMode READ horizontalScrollMode WRITE setHorizontalScrollMode) | |
public: | |
enum SelectionMode { | |
NoSelection, | |
SingleSelection, | |
MultiSelection, | |
ExtendedSelection, | |
ContiguousSelection | |
}; | |
enum SelectionBehavior { | |
SelectItems, | |
SelectRows, | |
SelectColumns | |
}; | |
enum ScrollHint { | |
EnsureVisible, | |
PositionAtTop, | |
PositionAtBottom, | |
PositionAtCenter | |
}; | |
enum EditTrigger { | |
NoEditTriggers = 0, | |
CurrentChanged = 1, | |
DoubleClicked = 2, | |
SelectedClicked = 4, | |
EditKeyPressed = 8, | |
AnyKeyPressed = 16, | |
AllEditTriggers = 31 | |
}; | |
Q_DECLARE_FLAGS(EditTriggers, EditTrigger) | |
enum ScrollMode { | |
ScrollPerItem, | |
ScrollPerPixel | |
}; | |
explicit QAbstractItemView(QWidget *parent = 0); | |
~QAbstractItemView(); | |
virtual void setModel(QAbstractItemModel *model); | |
QAbstractItemModel *model() const; | |
virtual void setSelectionModel(QItemSelectionModel *selectionModel); | |
QItemSelectionModel *selectionModel() const; | |
void setItemDelegate(QAbstractItemDelegate *delegate); | |
QAbstractItemDelegate *itemDelegate() const; | |
void setSelectionMode(QAbstractItemView::SelectionMode mode); | |
QAbstractItemView::SelectionMode selectionMode() const; | |
void setSelectionBehavior(QAbstractItemView::SelectionBehavior behavior); | |
QAbstractItemView::SelectionBehavior selectionBehavior() const; | |
QModelIndex currentIndex() const; | |
QModelIndex rootIndex() const; | |
void setEditTriggers(EditTriggers triggers); | |
EditTriggers editTriggers() const; | |
void setVerticalScrollMode(ScrollMode mode); | |
ScrollMode verticalScrollMode() const; | |
void setHorizontalScrollMode(ScrollMode mode); | |
ScrollMode horizontalScrollMode() const; | |
void setAutoScroll(bool enable); | |
bool hasAutoScroll() const; | |
void setAutoScrollMargin(int margin); | |
int autoScrollMargin() const; | |
void setTabKeyNavigation(bool enable); | |
bool tabKeyNavigation() const; | |
#ifndef QT_NO_DRAGANDDROP | |
void setDropIndicatorShown(bool enable); | |
bool showDropIndicator() const; | |
void setDragEnabled(bool enable); | |
bool dragEnabled() const; | |
void setDragDropOverwriteMode(bool overwrite); | |
bool dragDropOverwriteMode() const; | |
enum DragDropMode { | |
NoDragDrop, | |
DragOnly, | |
DropOnly, | |
DragDrop, | |
InternalMove | |
}; | |
void setDragDropMode(DragDropMode behavior); | |
DragDropMode dragDropMode() const; | |
void setDefaultDropAction(Qt::DropAction dropAction); | |
Qt::DropAction defaultDropAction() const; | |
#endif | |
void setAlternatingRowColors(bool enable); | |
bool alternatingRowColors() const; | |
void setIconSize(const QSize &size); | |
QSize iconSize() const; | |
void setTextElideMode(Qt::TextElideMode mode); | |
Qt::TextElideMode textElideMode() const; | |
virtual void keyboardSearch(const QString &search); | |
virtual QRect visualRect(const QModelIndex &index) const = 0; | |
virtual void scrollTo(const QModelIndex &index, ScrollHint hint = EnsureVisible) = 0; | |
virtual QModelIndex indexAt(const QPoint &point) const = 0; | |
QSize sizeHintForIndex(const QModelIndex &index) const; | |
virtual int sizeHintForRow(int row) const; | |
virtual int sizeHintForColumn(int column) const; | |
void openPersistentEditor(const QModelIndex &index); | |
void closePersistentEditor(const QModelIndex &index); | |
void setIndexWidget(const QModelIndex &index, QWidget *widget); | |
QWidget *indexWidget(const QModelIndex &index) const; | |
void setItemDelegateForRow(int row, QAbstractItemDelegate *delegate); | |
QAbstractItemDelegate *itemDelegateForRow(int row) const; | |
void setItemDelegateForColumn(int column, QAbstractItemDelegate *delegate); | |
QAbstractItemDelegate *itemDelegateForColumn(int column) const; | |
QAbstractItemDelegate *itemDelegate(const QModelIndex &index) const; | |
virtual QVariant inputMethodQuery(Qt::InputMethodQuery query) const; | |
#ifdef Q_NO_USING_KEYWORD | |
inline void update() { QAbstractScrollArea::update(); } | |
#else | |
using QAbstractScrollArea::update; | |
#endif | |
public Q_SLOTS: | |
virtual void reset(); | |
virtual void setRootIndex(const QModelIndex &index); | |
virtual void doItemsLayout(); | |
virtual void selectAll(); | |
void edit(const QModelIndex &index); | |
void clearSelection(); | |
void setCurrentIndex(const QModelIndex &index); | |
void scrollToTop(); | |
void scrollToBottom(); | |
void update(const QModelIndex &index); | |
protected Q_SLOTS: | |
virtual void dataChanged(const QModelIndex &topLeft, const QModelIndex &bottomRight); | |
virtual void rowsInserted(const QModelIndex &parent, int start, int end); | |
virtual void rowsAboutToBeRemoved(const QModelIndex &parent, int start, int end); | |
virtual void selectionChanged(const QItemSelection &selected, const QItemSelection &deselected); | |
virtual void currentChanged(const QModelIndex ¤t, const QModelIndex &previous); | |
virtual void updateEditorData(); | |
virtual void updateEditorGeometries(); | |
virtual void updateGeometries(); | |
virtual void verticalScrollbarAction(int action); | |
virtual void horizontalScrollbarAction(int action); | |
virtual void verticalScrollbarValueChanged(int value); | |
virtual void horizontalScrollbarValueChanged(int value); | |
virtual void closeEditor(QWidget *editor, QAbstractItemDelegate::EndEditHint hint); | |
virtual void commitData(QWidget *editor); | |
virtual void editorDestroyed(QObject *editor); | |
Q_SIGNALS: | |
void pressed(const QModelIndex &index); | |
void clicked(const QModelIndex &index); | |
void doubleClicked(const QModelIndex &index); | |
void activated(const QModelIndex &index); | |
void entered(const QModelIndex &index); | |
void viewportEntered(); | |
protected: | |
QAbstractItemView(QAbstractItemViewPrivate &, QWidget *parent = 0); | |
void setHorizontalStepsPerItem(int steps); | |
int horizontalStepsPerItem() const; | |
void setVerticalStepsPerItem(int steps); | |
int verticalStepsPerItem() const; | |
enum CursorAction { MoveUp, MoveDown, MoveLeft, MoveRight, | |
MoveHome, MoveEnd, MovePageUp, MovePageDown, | |
MoveNext, MovePrevious }; | |
virtual QModelIndex moveCursor(CursorAction cursorAction, | |
Qt::KeyboardModifiers modifiers) = 0; | |
virtual int horizontalOffset() const = 0; | |
virtual int verticalOffset() const = 0; | |
virtual bool isIndexHidden(const QModelIndex &index) const = 0; | |
virtual void setSelection(const QRect &rect, QItemSelectionModel::SelectionFlags command) = 0; | |
virtual QRegion visualRegionForSelection(const QItemSelection &selection) const = 0; | |
virtual QModelIndexList selectedIndexes() const; | |
virtual bool edit(const QModelIndex &index, EditTrigger trigger, QEvent *event); | |
virtual QItemSelectionModel::SelectionFlags selectionCommand(const QModelIndex &index, | |
const QEvent *event = 0) const; | |
#ifndef QT_NO_DRAGANDDROP | |
virtual void startDrag(Qt::DropActions supportedActions); | |
#endif | |
virtual QStyleOptionViewItem viewOptions() const; | |
enum State { | |
NoState, | |
DraggingState, | |
DragSelectingState, | |
EditingState, | |
ExpandingState, | |
CollapsingState, | |
AnimatingState | |
}; | |
State state() const; | |
void setState(State state); | |
void scheduleDelayedItemsLayout(); | |
void executeDelayedItemsLayout(); | |
void setDirtyRegion(const QRegion ®ion); | |
void scrollDirtyRegion(int dx, int dy); | |
QPoint dirtyRegionOffset() const; | |
void startAutoScroll(); | |
void stopAutoScroll(); | |
void doAutoScroll(); | |
bool focusNextPrevChild(bool next); | |
bool event(QEvent *event); | |
bool viewportEvent(QEvent *event); | |
void mousePressEvent(QMouseEvent *event); | |
void mouseMoveEvent(QMouseEvent *event); | |
void mouseReleaseEvent(QMouseEvent *event); | |
void mouseDoubleClickEvent(QMouseEvent *event); | |
#ifndef QT_NO_DRAGANDDROP | |
void dragEnterEvent(QDragEnterEvent *event); | |
void dragMoveEvent(QDragMoveEvent *event); | |
void dragLeaveEvent(QDragLeaveEvent *event); | |
void dropEvent(QDropEvent *event); | |
#endif | |
void focusInEvent(QFocusEvent *event); | |
void focusOutEvent(QFocusEvent *event); | |
void keyPressEvent(QKeyEvent *event); | |
void resizeEvent(QResizeEvent *event); | |
void timerEvent(QTimerEvent *event); | |
void inputMethodEvent(QInputMethodEvent *event); | |
#ifndef QT_NO_DRAGANDDROP | |
enum DropIndicatorPosition { OnItem, AboveItem, BelowItem, OnViewport }; | |
DropIndicatorPosition dropIndicatorPosition() const; | |
#endif | |
private: | |
Q_DECLARE_PRIVATE(QAbstractItemView) | |
Q_DISABLE_COPY(QAbstractItemView) | |
Q_PRIVATE_SLOT(d_func(), void _q_columnsAboutToBeRemoved(const QModelIndex&, int, int)) | |
Q_PRIVATE_SLOT(d_func(), void _q_columnsRemoved(const QModelIndex&, int, int)) | |
Q_PRIVATE_SLOT(d_func(), void _q_columnsInserted(const QModelIndex&, int, int)) | |
Q_PRIVATE_SLOT(d_func(), void _q_rowsRemoved(const QModelIndex&, int, int)) | |
Q_PRIVATE_SLOT(d_func(), void _q_modelDestroyed()) | |
Q_PRIVATE_SLOT(d_func(), void _q_layoutChanged()) | |
Q_PRIVATE_SLOT(d_func(), void _q_headerDataChanged()) | |
friend class QTreeViewPrivate; // needed to compile with MSVC | |
friend class QAccessibleItemRow; | |
friend class QListModeViewBase; | |
friend class QListViewPrivate; // needed to compile for Symbian emulator | |
}; | |
Q_DECLARE_OPERATORS_FOR_FLAGS(QAbstractItemView::EditTriggers) | |
#endif // QT_NO_ITEMVIEWS | |
QT_END_NAMESPACE | |
QT_END_HEADER | |
#endif // QABSTRACTITEMVIEW_H |