QAbstractScrollArea 类

    QSize areaSize = viewport()->size();
    QSize  widgetSize = widget->size();

    verticalScrollBar()->setPageStep(areaSize.height());
    horizontalScrollBar()->setPageStep(areaSize.width());
    verticalScrollBar()->setRange(0, widgetSize.height() - areaSize.height());
    horizontalScrollBar()->setRange(0, widgetSize.width() - areaSize.width());
    updateWidgetPosition();

    int hvalue = horizontalScrollBar()->value();
    int vvalue = verticalScrollBar()->value();
    QPoint topLeft = viewport()->rect().topLeft();

    widget->move(topLeft.x() - hvalue, topLeft.y() - vvalue);

成员函数文档

[明确] QAbstractScrollArea::QAbstractScrollArea(QWidget *parent = nullptr)

构建一个viewport。

parent 参数会发送到 QWidget 构造函数。

[虚 noexcept] QAbstractScrollArea::~QAbstractScrollArea()

销毁viewport。

void QAbstractScrollArea::addScrollBarWidget(QWidget *widget, Qt::Alignment alignment)

将 widget 添加为位于由 alignment 指定的位置的滚动条控件。

滚动条控件显示在水平或垂直滚动条旁边，并可以放置在它的任何一侧。如果您希望滚动条控件始终可见，请将相应滚动条的 scrollBarPolicy 设置为 AlwaysOn。

alignment 必须是 Qt::Alignleft 和 Qt::AlignRight 之一，这映射到水平滚动条，或者 Qt::AlignTop 和 Qt::AlignBottom，这映射到垂直滚动条。

可以通过重新排列小部件或删除小部件来移除滚动条控件。还可以使用 QWidget::hide() 隐藏控件。

滚动条控件将调整大小以适合当前样式下的滚动条几何形状。以下描述了水平滚动条上的滚动条控件的情况

小部件的高度将设置为与滚动条高度匹配。要控制小部件的宽度，请使用 QWidget::setMinimumWidth 和 QWidget::setMaximumWidth，或实现 QWidget::sizeHint() 并设置一个水平大小策略。如果您要一个正方形的小部件，请调用 QStyle::pixelMetric(QStyle::PM_ScrollBarExtent) 并将宽度设置为该值。

另请参阅scrollBarWidgets。

[重写虚受保护] void QAbstractScrollArea::contextMenuEvent(QContextMenuEvent *e)

重实现: QWidget::contextMenuEvent(QContextMenuEvent *event)。

此事件处理程序可以在子类中重写，以接收viewport()小部件的上下文菜单事件。事件通过e传递。

另请参阅 QWidget::contextMenuEvent。

QWidget *QAbstractScrollArea::cornerWidget() const

返回两个滚动条之间的角落中的小部件。

默认情况下，没有角落小部件。

另请参阅 setCornerWidget。

[重写虚保护] void QAbstractScrollArea::dragEnterEvent(QDragEnterEvent *event)

重实现: QWidget::dragEnterEvent(QDragEnterEvent *event)

此事件处理程序可以在子类中重写，以接收viewport()小部件的拖入事件（通过event传递）。

另请参阅 QWidget::dragEnterEvent。

[重写虚保护] void QAbstractScrollArea::dragLeaveEvent(QDragLeaveEvent *event)

重实现: QWidget::dragLeaveEvent(QDragLeaveEvent *event)

此事件处理程序可以在子类中重写，以接收viewport()小部件的拖出事件（通过event传递）。

另请参阅 QWidget::dragLeaveEvent。

[重写虚保护] void QAbstractScrollArea::dragMoveEvent(QDragMoveEvent *event)

重实现: QWidget::dragMoveEvent(QDragMoveEvent *event)

此事件处理程序可以在子类中重写，以接收viewport()小部件的拖动事件（通过event传递）。

另请参阅 QWidget::dragMoveEvent。

[重写虚保护] void QAbstractScrollArea::dropEvent(QDropEvent *event)

重实现: QWidget::dropEvent(QDropEvent *event)

此事件处理程序可以在子类中重写，以接收viewport()小部件的放下事件（通过event传递）。

另请参阅 QWidget::dropEvent。

[重写虚保护] bool QAbstractScrollArea::event(QEvent *event)

重实现: QFrame::event(QEvent *e)

这是QAbstractScrollArea小部件（不是滚动区域viewport）的主要事件处理程序。指定的e是通用事件对象，可能需要根据它的类型转换为相应的类。

另请参阅 QEvent::type。

QScrollBar *QAbstractScrollArea::horizontalScrollBar() const

返回水平滚动条。

另请参阅setHorizontalScrollBar()，horizontalScrollBarPolicy 和 verticalScrollBar。

[重写虚保护] void QAbstractScrollArea::keyPressEvent(QKeyEvent *e)

重写： QWidget::keyPressEvent(QKeyEvent *event).

当按键时，该函数会被调用，携带按键事件 e。它处理 PageUp，PageDown，上，下，左和右按键，其他所有按键被忽略。

QSize QAbstractScrollArea::maximumViewportSize() const

返回视口的大小，就像滚动条没有有效的滚动范围一样。

[重写虚] QSize QAbstractScrollArea::minimumSizeHint() const

重写访问属性：QWidget::minimumSizeHint.

[重写虚保护] void QAbstractScrollArea::mouseDoubleClickEvent(QMouseEvent *e)

重写：QWidget::mouseDoubleClickEvent(QMouseEvent *event).

这个事件处理程序可以被子类重写以接收 viewport() 小部件的鼠标双击事件。事件通过 e 传递。

另请参阅QWidget::mouseDoubleClickEvent。

[重写虚保护] void QAbstractScrollArea::mouseMoveEvent(QMouseEvent *e)

重写：QWidget::mouseMoveEvent(QMouseEvent *event).

这个事件处理程序可以被子类重写以接收 viewport() 小部件的鼠标移动事件。事件通过 e 传递。

另请参阅QWidget::mouseMoveEvent。

[重写虚保护] void QAbstractScrollArea::mousePressEvent(QMouseEvent *e)

重写：QWidget::mousePressEvent(QMouseEvent *event).

这个事件处理程序可以被子类重写以接收 viewport() 小部件的鼠标按下事件。事件通过 e 传递。

默认实现调用 QWidget::mousePressEvent() 以处理默认弹出。

另请参阅QWidget::mousePressEvent。

[重写虚保护] void QAbstractScrollArea::mouseReleaseEvent(QMouseEvent *e)

重写：QWidget::mouseReleaseEvent(QMouseEvent *event).

这个事件处理程序可以被子类重写以接收 viewport() 小部件的鼠标释放事件。事件通过 e 传递。

另请参阅QWidget::mouseReleaseEvent。

[重写虚受保护] void QAbstractScrollArea::paintEvent(QPaintEvent *event)

重写了： QFrame::paintEvent(QPaintEvent *).

此事件处理函数可以在子类中重写，用于接收（通过 event 传入）viewport() 小部件的绘制事件。

另请参阅 QWidget::paintEvent。

[重写虚受保护] void QAbstractScrollArea::resizeEvent(QResizeEvent *event)

重写了： QWidget::resizeEvent(QResizeEvent *event).

此事件处理函数可以在子类中重写，用于接收（通过 event 传入）viewport() 小部件的调整大小事件。

当调用 resizeEvent() 时，viewport 已经具有了新的几何形状：其新大小可以通过 QResizeEvent::size() 函数访问，旧大小通过 QResizeEvent::oldSize() 访问。

另请参阅 QWidget::resizeEvent。

QWidgetList QAbstractScrollArea::scrollBarWidgets(Qt::Alignment alignment)

返回当前设置的滚动条小部件的列表。alignment 可以是四个位置标记的组合中的任意组合。

另请参阅 addScrollBarWidget。

[虚受保护] void QAbstractScrollArea::scrollContentsBy(int dx, int dy)

当滚动条移动了 dx，dy 时，将调用此虚拟处理程序，并且viewport的内容应该相应地滚动。

默认实现简单地在整个 viewport 上调用 update()，子类可以根据优化目的重写此处理程序，或者像 QScrollArea 一样移动内容小部件。参数 dx 和 dy 是为了方便而设置的，以便该类知道应该滚动多少（例如，在执行像素移动时很有用）。你也可以忽略这些值，直接滚动到滚动条所指示的位置。

progamatically调用此函数以进行滚动是错误的，应使用滚动条而不是（例如，通过直接调用QScrollBar::setValue()).

void QAbstractScrollArea::setCornerWidget(QWidget *widget)

设置在两个滚动条之间角的部件为 widget。

你可能还会想将至少一个滚动条模式设置为 AlwaysOn。

传递 nullptr 表示在角落中不显示任何小部件。

任何先前的角落小部件都将被隐藏。

你可以多次用相同的部件调用 setCornerWidget()。

当你设置另一个角落小部件或传递 nullptr 后，scroll area 会删除在这里设置的任何小部件（除非你在设置其他角落小部件后单独将小部件重新设置为父控件）。

任何新设置的小部件不应有任何当前父控件。

默认情况下，没有角落小部件。

另请参阅 cornerWidget()，horizontalScrollBarPolicy 以及 horizontalScrollBarPolicy。

void QAbstractScrollArea::setHorizontalScrollBar(QScrollBar *scrollBar)

用 scrollBar 替换现有的水平滚动条，并将之前滚动条的滑块属性设置到新滚动条上。然后删除之前的滚动条。

QAbstractScrollArea 默认已提供水平和垂直滚动条。您可以通过调用此函数将默认水平滚动条替换为您自定义的滚动条。

另请参阅 horizontalScrollBar() 和 setVerticalScrollBar()。

void QAbstractScrollArea::setVerticalScrollBar(QScrollBar *scrollBar)

用 scrollBar 替换现有的垂直滚动条，并将之前滚动条的滑块属性设置到新滚动条上。然后删除之前的滚动条。

QAbstractScrollArea 默认已提供水平和垂直滚动条。您可以通过调用此函数将默认垂直滚动条替换为您自定义的滚动条。

另请参阅 verticalScrollBar() 和 setHorizontalScrollBar。

void QAbstractScrollArea::setViewport(QWidget *widget)

将视口设置为指定的 widget。QAbstractScrollArea 将获取给定 widget 的所有权。

如果 widget 是 nullptr，QAbstractScrollArea 将为视口分配一个新的 QWidget 实例。

另请参阅 viewport。

[protected] void QAbstractScrollArea::setViewportMargins(int left, int top, int right, int bottom)

将滚动区域周围的边距设置为 left、top、right 和 bottom。这对于像有“锁定”行和列的电子表格等应用程序很有用。留出空白的空间用于未用的区域，并将小部件放在未用区域中。

请注意，此函数通常由 QTreeView 和 QTableView 调用，因此 QAbstractScrollArea 子类必须实现边距。此外，如果子类要用于项目视图，则不应调用此函数。

默认情况下，所有边距都是零。

另请参阅 viewportMargins。

[protected] void QAbstractScrollArea::setViewportMargins(const QMargins &margins)

设置滚动区域的 margins。这对于像有“锁定”行和列的电子表格等应用程序很有用。留出空白的空间用于未用的区域，并将小部件放在未用区域中。

默认情况下，所有边距都是零。

另请参阅 viewportMargins。

[虚拟] void QAbstractScrollArea::setupViewport(QWidget *viewport)

此槽函数在调用 QAbstractScrollArea 的 setViewport(viewport) 后被调用。在 QAbstractScrollArea 的子类中重新实现此函数，以便在使用之前初始化新的 viewport。

另请参阅setViewport。

[重写虚函数] QSize QAbstractScrollArea::sizeHint() const

重写: QFrame::sizeHint() const.

返回滚动区域的 sizeHint 属性。大小由使用 viewportSizeHint() 加上为滚动条保留的额外空间（如有必要）来确定。

QScrollBar *QAbstractScrollArea::verticalScrollBar() const

返回垂直滚动条。

另请参阅setVerticalScrollBar()，verticalScrollBarPolicy 和 horizontalScrollBar()。

QWidget *QAbstractScrollArea::viewport() const

返回视口小部件。

使用 QScrollArea::widget() 函数检索视口小部件的内容。

另请参阅setViewport() 和 QScrollArea::widget()。

[虚拟受保护] bool QAbstractScrollArea::viewportEvent(QEvent *event)

滚动区域的 主事件处理器（viewport() 小部件）。它处理指定的 event，可以由子类调用以提供合理的基本行为。

返回 true 以指示事件系统该事件已被处理，无需进一步处理；否则返回 false 以指示事件应进一步传播。

您可以在子类中重新实现此函数，但建议使用专业的事件处理器之一。

视口事件的专业处理程序包括：paintEvent()，mousePressEvent()，mouseReleaseEvent()，mouseDoubleClickEvent()，mouseMoveEvent()，wheelEvent()，dragEnterEvent()，dragMoveEvent()，dragLeaveEvent()，dropEvent()，contextMenuEvent 和 resizeEvent()。

[受保护] QMargins QAbstractScrollArea::viewportMargins() const

返回滚动区域的边缘。默认情况下，所有边缘都是零。

另请参阅setViewportMargins。

[虚保护] QSize QAbstractScrollArea::viewportSizeHint() const

返回视口推荐的尺寸。默认实现返回 viewport() -> sizeHint()。注意，此尺寸仅为视口尺寸，无任何滚动条可见。

[重载虚拟保护] void QAbstractScrollArea::wheelEvent(QWheelEvent *e)

重实现：QWidget::wheelEvent(QWheelEvent *event)。

此事件处理器可以在子类中重实现，以接收 viewport() 小部件的轮事件。事件通过 e 传入。

另请参阅QWidget::wheelEvent。