QScrollArea Class

QLabel *imageLabel = new QLabel;
QImage image("happyguy.png");
imageLabel->setPixmap(QPixmap::fromImage(image));

scrollArea = new QScrollArea;
scrollArea->setBackgroundRole(QPalette::Dark);
scrollArea->setWidget(imageLabel);

成员函数文档

[explicit] QScrollArea::QScrollArea(QWidget *parent = nullptr)

根据给定的parent ，构建一个空的滚动区域。

另请参阅 setWidget()。

[virtual noexcept] QScrollArea::~QScrollArea()

销毁滚动区域及其子控件。

另请参阅 setWidget()。

void QScrollArea::ensureVisible(int x, int y, int xmargin = 50, int ymargin = 50)

滚动滚动区域的内容，使点 (x,y) 显示在视口区域内，该视口的边距（以像素为单位）由xmargin 和ymargin 指定。如果无法到达指定的点，则将内容滚动到最近的有效位置。这两个边距的默认值均为 50 像素。

void QScrollArea::ensureWidgetVisible(QWidget *childWidget, int xmargin = 50, int ymargin = 50)

滚动卷轴区域的内容，使QScrollArea::widget()中的childWidget 在视口内可见，并按照xmargin 和ymargin 中以像素为单位指定的边距进行滚动。如果无法到达指定的位置，则将内容滚动到最近的有效位置。这两个边距的默认值均为50像素。

[override virtual protected] bool QScrollArea::event(QEvent *e)

重写了：QAbstractScrollArea::event(QEvent *event)。

[override virtual protected] bool QScrollArea::eventFilter(QObject *o, QEvent *e)

重写了：QObject::eventFilter(QObject *watched, QEvent *event)。

[override virtual] bool QScrollArea::focusNextPrevChild(bool next)

重新实现了：QWidget::focusNextPrevChild （bool next）。

[override virtual protected] void QScrollArea::resizeEvent(QResizeEvent *)

重写了：QAbstractScrollArea::resizeEvent(QResizeEvent *event)。

[override virtual protected] void QScrollArea::scrollContentsBy(int dx, int dy)

重新实现了：QAbstractScrollArea::scrollContentsBy(int dx, int dy)。

void QScrollArea::setWidget(QWidget *widget)

设置滚动区域的widget 。

widget 将成为滚动区域的子控件，并在滚动区域被删除或设置了新的控件时被销毁。

该小部件的autoFillBackground 属性将被设置为true 。

如果在添加widget 时滚动区域处于可见状态，则必须显式地调用show()。

请注意：您必须在调用此函数之前添加widget 的布局；如果稍后才添加，则widget 将不可见——无论您何时对滚动区域调用show()。在这种情况下，您也无法在后续对widget 调用show()。

另请参阅 widget()。

[override virtual] QSize QScrollArea::sizeHint() const

重新实现了：QAbstractScrollArea::sizeHint() const。

QWidget *QScrollArea::takeWidget()

移除滚动区域的小部件，并将该小部件的所有权移交给调用方。

另请参阅 widget()。

[override virtual protected] QSize QScrollArea::viewportSizeHint() const

重新实现了：QAbstractScrollArea::viewportSizeHint() const。

QWidget *QScrollArea::widget() const

返回滚动区域的小部件，如果不存在则返回nullptr 。

另请参阅 setWidget()。