QScroller实现QTableView的滚动、滑动效果

QScroller 是 Qt 提供的一个非常强大的工具，专门用于实现滚动效果，包括触摸屏上的平滑滚动、惯性滚动等。它是 Qt Quick 和 Qt Widgets 中实现触摸滚动的推荐方式。

以下是如何使用 QScroller 来为 QTableView 或其他滚动区域实现平滑滚动的详细步骤：

1. 启用 QScroller

QScroller 需要被显式启用，因为它默认是禁用的。可以通过调用 QScroller::grabGesture 方法来启用滚动手势。

示例代码：

#include <QScroller>
#include <QTableView>
#include <QApplication>

int main(int argc, char *argv[]) {
    QApplication app(argc, argv);

    QTableView tableView;
    // 设置表格模型（示例）
    QStandardItemModel model(100, 2);
    tableView.setModel(&model);

    // 启用 QScroller
    QScroller::grabGesture(tableView.viewport(), QScroller::TouchGesture);

    tableView.show();
    return app.exec();
}

2. 配置 QScroller 的滚动参数

QScroller 提供了丰富的参数来配置滚动行为，例如滚动速度、加速度、惯性等。这些参数可以通过 QScrollerProperties 来设置。

示例代码：

QScrollerProperties scrollerProperties = QScroller::scroller(tableView.viewport())->scrollerProperties();

// 设置滚动参数
scrollerProperties.setScrollMetric(QScrollerProperties::DragVelocitySmoothingFactor, 0.8);
scrollerProperties.setScrollMetric(QScrollerProperties::MinimumVelocity, 50);
scrollerProperties.setScrollMetric(QScrollerProperties::MaximumVelocity, 2000);
scrollerProperties.setScrollMetric(QScrollerProperties::Acceleration, 0.0001);
scrollerProperties.setScrollMetric(QScrollerProperties::Deceleration, 0.0003);

// 应用配置
QScroller::scroller(tableView.viewport())->setScrollerProperties(scrollerProperties);

3. 确保滚动区域的交互性

为了使 QScroller 正常工作，需要确保滚动区域（如 QTableView 的 viewport）能够接收触摸事件。通常，这需要启用 Qt::StrongFocus 或 Qt::WheelFocus。

示例代码：

tableView.viewport()->setFocusPolicy(Qt::StrongFocus);

4. 为其他控件启用 QScroller

QScroller 不仅适用于 QTableView，还可以用于其他支持滚动的控件，如 QScrollArea、QTextEdit 等。只需将 QScroller::grabGesture 应用到对应的控件的 viewport 或滚动区域即可。

示例代码：

QScrollArea scrollArea;
QScroller::grabGesture(scrollArea.viewport(), QScroller::TouchGesture);

5. 注意事项

• Qt 版本：QScroller 在较新的 Qt 版本中表现更好，尤其是在 Qt 5.10 及以上版本中。如果你使用的是较旧的版本，可能会遇到一些兼容性问题。
• 平台支持：QScroller 在触摸屏设备上表现最佳，但在桌面环境中也可以通过鼠标模拟触摸滚动。
• 性能优化：如果滚动区域包含大量数据或复杂布局，可能需要优化性能。例如，为 QTableView 启用 QAbstractItemView::VerticalScrollMode 或 QAbstractItemView::SmoothScroll。

完整示例代码

以下是一个完整的示例，展示如何为 QTableView 启用并配置 QScroller：

#include <QApplication>
#include <QTableView>
#include <QStandardItemModel>
#include <QScroller>
#include <QScrollerProperties>

int main(int argc, char *argv[]) {
    QApplication app(argc, argv);

    QTableView tableView;
    QStandardItemModel model(100, 2);  // 示例数据模型
    tableView.setModel(&model);

    // 启用 QScroller
    QScroller::grabGesture(tableView.viewport(), QScroller::TouchGesture);

    // 配置滚动参数
    QScrollerProperties scrollerProperties = QScroller::scroller(tableView.viewport())->scrollerProperties();
    scrollerProperties.setScrollMetric(QScrollerProperties::DragVelocitySmoothingFactor, 0.8);
    scrollerProperties.setScrollMetric(QScrollerProperties::MinimumVelocity, 50);
    scrollerProperties.setScrollMetric(QScrollerProperties::MaximumVelocity, 2000);
    scrollerProperties.setScrollMetric(QScrollerProperties::Acceleration, 0.0001);
    scrollerProperties.setScrollMetric(QScrollerProperties::Deceleration, 0.0003);
    QScroller::scroller(tableView.viewport())->setScrollerProperties(scrollerProperties);

    // 确保滚动区域可以接收触摸事件
    tableView.viewport()->setFocusPolicy(Qt::StrongFocus);

    tableView.show();
    return app.exec();
}

总结

QScroller 是 Qt 提供的用于实现平滑滚动和触摸滚动的强大工具。通过启用 QScroller 并配置滚动参数，你可以轻松为 QTableView 或其他滚动控件实现类似鼠标滚轮的滚动效果，同时支持触摸屏的平滑滚动和惯性滚动。