dlistview.h

浏览该文件的文档.

// SPDX-FileCopyrightText: 2015 - 2022 UnionTech Software Technology Co., Ltd.
//
// SPDX-License-Identifier: LGPL-3.0-or-later
 
#ifndef DLISTVIEW_H
#define DLISTVIEW_H
 
#include <dtkwidget_global.h>
 
#include <dobject.h>
#include <DStyledItemDelegate>
 
#include <QListView>
 
DWIDGET_BEGIN_NAMESPACE
 
class DVariantListModel : public QAbstractListModel
{
public:
    explicit DVariantListModel(QObject *parent = 0);
 
    int rowCount(const QModelIndex &parent = QModelIndex()) const Q_DECL_OVERRIDE;
    QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const Q_DECL_OVERRIDE;
    bool setData(const QModelIndex &index, const QVariant &value, int role) Q_DECL_OVERRIDE;
 
    bool insertRows(int row, int count, const QModelIndex &parent = QModelIndex()) Q_DECL_OVERRIDE;
    bool removeRows(int row, int count, const QModelIndex &parent = QModelIndex()) Q_DECL_OVERRIDE;
 
private:
    QList<QVariant> dataList;
};
 
class DListViewPrivate;
class LIBDTKWIDGETSHARED_EXPORT DListView : public QListView, public DTK_CORE_NAMESPACE::DObject
{
    Q_OBJECT
 
    Q_PROPERTY(int count READ count NOTIFY rowCountChanged)
    Q_PROPERTY(Qt::Orientation orientation READ orientation NOTIFY orientationChanged)
    Q_PROPERTY(DStyledItemDelegate::BackgroundType backgroundType READ backgroundType WRITE setBackgroundType)
    Q_PROPERTY(QMargins itemMargins READ itemMargins WRITE setItemMargins)
    Q_PROPERTY(QSize itemSize READ itemSize WRITE setItemSize)
 
public:
    explicit DListView(QWidget *parent = 0);
 
    State state() const;
 
    QWidget *getHeaderWidget(int index) const;
    QWidget *getFooterWidget(int index) const;
 
    bool isActiveRect(const QRect &rect) const;
    bool isVisualRect(const QRect &rect) const;
 
    int count() const;
 
    Qt::Orientation orientation() const;
 
    void setModel(QAbstractItemModel *model) Q_DECL_OVERRIDE;
    QSize minimumSizeHint() const Q_DECL_OVERRIDE;
 
    DStyledItemDelegate::BackgroundType backgroundType() const;
    QMargins itemMargins() const;
    QSize itemSize() const;
 
    using QListView::contentsSize;
    using QListView::setViewportMargins;
 
public Q_SLOTS:
    bool addItem(const QVariant &data);
    bool addItems(const QVariantList &datas);
    bool insertItem(int index, const QVariant &data);
    bool insertItems(int index, const QVariantList &datas);
    bool removeItem(int index);
    bool removeItems(int index, int count);
 
    int addHeaderWidget(QWidget *widget);
    void removeHeaderWidget(int index);
    QWidget *takeHeaderWidget(int index);
    int addFooterWidget(QWidget *widget);
    void removeFooterWidget(int index);
    QWidget *takeFooterWidget(int index);
 
    void setOrientation(QListView::Flow flow, bool wrapping);
    void edit(const QModelIndex &index);
 
    void setBackgroundType(DStyledItemDelegate::BackgroundType backgroundType);
    void setItemMargins(const QMargins &itemMargins);
    void setItemSize(QSize itemSize);
    void setItemSpacing(int spacing);
    void setItemRadius(int radius);
 
Q_SIGNALS:
    void rowCountChanged();
    void orientationChanged(Qt::Orientation orientation);
    void currentChanged(const QModelIndex &previous);
    void triggerEdit(const QModelIndex &index);
 
protected:
#if(QT_VERSION < 0x050500)
    void setViewportMargins(int left, int top, int right, int bottom);
    void setViewportMargins(const QMargins &margins);
    QMargins viewportMargins() const;
#endif
 
    void resizeEvent(QResizeEvent *event) Q_DECL_OVERRIDE;
    void currentChanged(const QModelIndex &current, const QModelIndex &previous) Q_DECL_OVERRIDE;
    bool edit(const QModelIndex &index, EditTrigger trigger, QEvent *event) Q_DECL_OVERRIDE;
 
#if QT_VERSION < QT_VERSION_CHECK(6, 0, 0)
    QStyleOptionViewItem viewOptions() const override;
#else
    void initViewItemOption(QStyleOptionViewItem *option) const override;
#endif
    virtual QModelIndex moveCursor(CursorAction cursorAction,
                                   Qt::KeyboardModifiers modifiers) override;
    QSize viewportSizeHint() const override;
    int horizontalOffset() const override;
 
private:
    void setFlow(QListView::Flow flow);
    void setWrapping(bool enable);
 
    D_DECLARE_PRIVATE(DListView)
};
 
DWIDGET_END_NAMESPACE
 
#endif // DLISTVIEW_H