q3listview.h

qt-x11-opensource-src-4.1.4.tar.gz源码

/****************************************************************************
**
** Copyright (C) 1992-2006 Trolltech ASA. All rights reserved.
**
** This file is part of the Qt3Support module of the Qt Toolkit.
**
** This file may be used under the terms of the GNU General Public
** License version 2.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 GNU
** General Public Licensing requirements will be met:
** http://www.trolltech.com/products/qt/opensource.html
**
** If you are unsure which license is appropriate for your use, please
** review the following information:
** http://www.trolltech.com/products/qt/licensing.html or contact the
** sales department at [e-mail].
**
** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
**
****************************************************************************/

#ifndef Q3LISTVIEW_H
#define Q3LISTVIEW_H

#include <Qt3Support/q3scrollview.h>

QT_BEGIN_HEADER

QT_MODULE(Qt3SupportLight)

#ifndef QT_NO_LISTVIEW

class QPixmap;
class QFont;
class Q3Header;
class QIcon;

class Q3ListView;
struct Q3ListViewPrivate;
struct Q3CheckListItemPrivate;
class Q3ListViewItemIterator;
struct Q3ListViewItemIteratorPrivate;
class Q3DragObject;
class QMimeSource;
class QLineEdit;
class Q3ListViewToolTip;

class Q_COMPAT_EXPORT Q3ListViewItem
{
    friend class Q3ListViewItemIterator;
    friend class Q3ListViewToolTip;

public:
    Q3ListViewItem(Q3ListView * parent);
    Q3ListViewItem(Q3ListViewItem * parent);
    Q3ListViewItem(Q3ListView * parent, Q3ListViewItem * after);
    Q3ListViewItem(Q3ListViewItem * parent, Q3ListViewItem * after);

    Q3ListViewItem(Q3ListView * parent,
                   const QString&,             const QString& = QString(),
                   const QString& = QString(), const QString& = QString(),
                   const QString& = QString(), const QString& = QString(),
                   const QString& = QString(), const QString& = QString());
    Q3ListViewItem(Q3ListViewItem * parent,
                   const QString&,             const QString& = QString(),
                   const QString& = QString(), const QString& = QString(),
                   const QString& = QString(), const QString& = QString(),
                   const QString& = QString(), const QString& = QString());

    Q3ListViewItem(Q3ListView * parent, Q3ListViewItem * after,
                   const QString&,             const QString& = QString(),
                   const QString& = QString(), const QString& = QString(),
                   const QString& = QString(), const QString& = QString(),
                   const QString& = QString(), const QString& = QString());
    Q3ListViewItem(Q3ListViewItem * parent, Q3ListViewItem * after,
                   const QString&,             const QString& = QString(),
                   const QString& = QString(), const QString& = QString(),
                   const QString& = QString(), const QString& = QString(),
                   const QString& = QString(), const QString& = QString());
    virtual ~Q3ListViewItem();

    virtual void insertItem(Q3ListViewItem *);
    virtual void takeItem(Q3ListViewItem *);
    virtual void removeItem(Q3ListViewItem *item) { takeItem(item); }

    int height() const;
    virtual void invalidateHeight();
    int totalHeight() const;
    virtual int width(const QFontMetrics&,
                       const Q3ListView*, int column) const;
    void widthChanged(int column=-1) const;
    int depth() const;

    virtual void setText(int, const QString &);
    virtual QString text(int) const;

    virtual void setPixmap(int, const QPixmap &);
    virtual const QPixmap * pixmap(int) const;

    virtual QString key(int, bool) const;
    virtual int compare(Q3ListViewItem *i, int col, bool) const;
    virtual void sortChildItems(int, bool);

    int childCount() const { return nChildren; }

    bool isOpen() const { return open; }
    virtual void setOpen(bool);
    virtual void setup();

    virtual void setSelected(bool);
    bool isSelected() const { return selected; }

    virtual void paintCell(QPainter *, const QColorGroup & cg,
                            int column, int width, int alignment);
    virtual void paintBranches(QPainter * p, const QColorGroup & cg, int w, int y, int h);
    virtual void paintFocus(QPainter *, const QColorGroup & cg, const QRect & r);

    Q3ListViewItem * firstChild() const;
    Q3ListViewItem * nextSibling() const { return siblingItem; }
    Q3ListViewItem * parent() const;

    Q3ListViewItem * itemAbove() const;
    Q3ListViewItem * itemBelow() const;

    int itemPos() const;

    Q3ListView *listView() const;

    virtual void setSelectable(bool enable);
    bool isSelectable() const { return selectable && enabled; }

    virtual void setExpandable(bool);
    bool isExpandable() const { return expandable; }

    void repaint() const;

    virtual void sort();
    void moveItem(Q3ListViewItem *after);

    virtual void setDragEnabled(bool allow);
    virtual void setDropEnabled(bool allow);
    bool dragEnabled() const;
    bool dropEnabled() const;
    virtual bool acceptDrop(const QMimeSource *mime) const;

    void setVisible(bool b);
    bool isVisible() const;

    virtual void setRenameEnabled(int col, bool b);
    bool renameEnabled(int col) const;
    virtual void startRename(int col);

    virtual void setEnabled(bool b);
    bool isEnabled() const;

    virtual int rtti() const;
    enum { RTTI = 0 };

    virtual void setMultiLinesEnabled(bool b);
    bool multiLinesEnabled() const;

protected:
    virtual void enforceSortOrder() const;
    virtual void setHeight(int);
    virtual void activate();

    bool activatedPos(QPoint &);
#ifndef QT_NO_DRAGANDDROP
    virtual void dropped(QDropEvent *e);
#endif
    virtual void dragEntered();
    virtual void dragLeft();
    virtual void okRename(int col);
    virtual void cancelRename(int col);

    void ignoreDoubleClick();

private:
    void init();
    void moveToJustAfter(Q3ListViewItem *);
    void enforceSortOrderBackToRoot();
    void removeRenameBox();

    int ownHeight;
    int maybeTotalHeight;
    int nChildren;

    uint lsc: 14;
    uint lso: 1;
    uint open : 1;
    uint selected : 1;
    uint selectable: 1;
    uint configured: 1;
    uint expandable: 1;
    uint is_root: 1;
    uint allow_drag : 1;
    uint allow_drop : 1;
    uint visible : 1;
    uint enabled : 1;
    uint mlenabled : 1;

    Q3ListViewItem * parentItem;
    Q3ListViewItem * siblingItem;
    Q3ListViewItem * childItem;
    QLineEdit *renameBox;
    int renameCol;

    void * columns;

    friend class Q3ListView;
};

class Q3CheckListItem;

class Q_COMPAT_EXPORT Q3ListView : public Q3ScrollView
{
    friend class Q3ListViewItemIterator;
    friend class Q3ListViewItem;
    friend class Q3CheckListItem;
    friend class Q3ListViewToolTip;

    Q_OBJECT
    Q_ENUMS(SelectionMode ResizeMode RenameAction)
    Q_PROPERTY(int columns READ columns)
    Q_PROPERTY(bool multiSelection READ isMultiSelection WRITE setMultiSelection DESIGNABLE false)
    Q_PROPERTY(SelectionMode selectionMode READ selectionMode WRITE setSelectionMode)
    Q_PROPERTY(int childCount READ childCount)
    Q_PROPERTY(bool allColumnsShowFocus READ allColumnsShowFocus WRITE setAllColumnsShowFocus)
    Q_PROPERTY(bool showSortIndicator READ showSortIndicator WRITE setShowSortIndicator)
    Q_PROPERTY(int itemMargin READ itemMargin WRITE setItemMargin)
    Q_PROPERTY(bool rootIsDecorated READ rootIsDecorated WRITE setRootIsDecorated)
    Q_PROPERTY(bool showToolTips READ showToolTips WRITE setShowToolTips)
    Q_PROPERTY(ResizeMode resizeMode READ resizeMode WRITE setResizeMode)
    Q_PROPERTY(int treeStepSize READ treeStepSize WRITE setTreeStepSize)
    Q_PROPERTY(RenameAction defaultRenameAction READ defaultRenameAction WRITE setDefaultRenameAction)

public:
    Q3ListView(QWidget* parent=0, const char* name=0, Qt::WFlags f = 0);
    ~Q3ListView();

    int treeStepSize() const;
    virtual void setTreeStepSize(int);

    virtual void insertItem(Q3ListViewItem *);
    virtual void takeItem(Q3ListViewItem *);
    virtual void removeItem(Q3ListViewItem *item) { takeItem(item); }

    Q3Header * header() const;

    virtual int addColumn(const QString &label, int size = -1);
    virtual int addColumn(const QIcon& icon, const QString &label, int size = -1);
    virtual void removeColumn(int index);
    virtual void setColumnText(int column, const QString &label);
    virtual void setColumnText(int column, const QIcon& icon, const QString &label);
    QString columnText(int column) const;
    virtual void setColumnWidth(int column, int width);
    int columnWidth(int column) const;
    enum WidthMode { Manual, Maximum };
    virtual void setColumnWidthMode(int column, WidthMode);
    WidthMode columnWidthMode(int column) const;
    int columns() const;

    virtual void setColumnAlignment(int, int);
    int columnAlignment(int) const;

    void show();

    QVariant inputMethodQuery(Qt::InputMethodQuery query) const;
    Q3ListViewItem * itemAt(const QPoint & screenPos) const;
    QRect itemRect(const Q3ListViewItem *) const;
    int itemPos(const Q3ListViewItem *);

    void ensureItemVisible(const Q3ListViewItem *);

    void repaintItem(const Q3ListViewItem *) const;

    virtual void setMultiSelection(bool enable);
    bool isMultiSelection() const;

    enum SelectionMode { Single, Multi, Extended, NoSelection  };
    void setSelectionMode(SelectionMode mode);
    SelectionMode selectionMode() const;

    virtual void clearSelection();
    virtual void setSelected(Q3ListViewItem *, bool);
    void setSelectionAnchor(Q3ListViewItem *);
    bool isSelected(const Q3ListViewItem *) const;
    Q3ListViewItem * selectedItem() const;
    virtual void setOpen(Q3ListViewItem *, bool);
    bool isOpen(const Q3ListViewItem *) const;

    virtual void setCurrentItem(Q3ListViewItem *);