有些元件預設並沒有捲軸,例如QLabel,當視窗或父元件無法顯示其大小時,只會顯示部份區域,但不會出現捲軸,如果您希望這類元件可以出現捲軸,則可以使用QScrollArea。
QScrollArea包括三個部份,一個是水平捲軸、一個垂直捲軸、一個view port,view port為水平捲軸及垂直捲軸中的顯示區域。
在下面的這個範例程式中,使用QLabel並使用setPixmap()設定其顯示圖片,在 這邊使用QScrollArea的setWidget()將QLabel設定為view port中的顯示元件,並使用setHorizontalScrollBarPolicy()與setVerticalScrollBarPolicy ()設定總是顯示捲軸(Qt::ScrollBarAlwaysOn):
#include <QApplication>
#include <QLabel>
#include <QScrollArea>
#include <QPixmap>
int main(int argc, char *argv[]) {
    QApplication app(argc, argv);
    
    QLabel *label = new QLabel;
    label->setPixmap(QPixmap("caterpillar.jpg"));
    
    QScrollArea *scrollArea = new QScrollArea;    
    scrollArea->setWindowTitle("QScrollArea");
    scrollArea->setWidget(label);
    scrollArea->setHorizontalScrollBarPolicy(Qt::ScrollBarAlwaysOn);
    scrollArea->setVerticalScrollBarPolicy(Qt::ScrollBarAlwaysOn);
    scrollArea->viewport()->setBackgroundRole(QPalette::Red);
    scrollArea->show();
    
    return app.exec();
}您可以使用QScrollArea的viewport()方法取得水平、垂直捲軸間的view port,在這邊使用其setBackgroundRole()方法,設定view port所顯示元件外的區域顯示為灰色。
下圖為執行時的參考畫面,可以看到水平與垂直捲軸,而QLabel顯示圖片加上灰色區域即為view port區域:


