轉自 https://blog.csdn.net/qq_31073871/article/details/83117430

QScrollArea屬于控件容器類，可以直接在ui中拖出來。

對于QScrollArea，最難搞懂的就是：如何控制它，才能讓它在我們想要出現滾動條的時候出現滾動條。

我們拖入一個QScrollArea，再向他里面拖入4個button，觀察信息如下：

可以發現，4個button并不是直接位于QScrollArea中的，而是位于它的成員scorllAreaWidgetContents中的，這個成員的類型也是控件類型QWidget，也就是說，QScrollArea這個容器本身就套了兩層，我們放入的按鈕等控件，都處在scrllAreaWidgetContents層，下文中我把QScrollArea.widget統一稱之為“內部容器”，內部容器是QScrollArea這個控件的子控件。

補充一點，內層的這個scrllAreaWidgetContents，我們可以更換掉它，方法就是QScrollArea::setWidget(QWidget *)，如果scrollArea控件是用鼠標拖出來的，那么QT會自動為我們new一個內部容器，如果scrollArea控件是用代碼創建的，那么不忘忘了為這個滾動區創建內部容器。

幫助文檔還指出，setWidget應當在“把想加的控件都加到內部容器”之后再調用，否則會無法顯示（然而，我測試發現，幫助說的不對，即使我們在setWidget之前沒有給內部容器設置布局也不要緊，只要在setWidget之后，內部容器調用一下adjustSize，就可以把內部容器的控件顯示出來，當然，為了保險起見，或者后續程序兼容性起見，還是按照幫助文檔來做吧）。

總結一下滾動區的標準編程步驟：

(1)new QscrollArea
(2)new 內部容器
(3)new 布局,例如網格布局QGridLayout（前3步不分先后順序）
(4)向布局中添加你想要的控件（這一步必須位于步驟3之后，這不是廢話嗎）
(5)關聯"內部容器"和"布局"（如果在創建布局時，就把布局構造在了內部容器中，那么這一步就省了）
(6)關聯"內部容器"和"滾動區"，也即調用QScrollArea::setWidget(QWidget *)，這一步必須位于步驟4、5之后。

?

?

一句話總結何時出現滾動條：

只要QScrollArea的尺寸 < 內部容器的尺寸，就會自動出現滾動條。下面舉個具體的例子：

程序初始時我們通過setGeometry設置內部容器的尺寸為100X100，QScrollArea放置在主界面的布局中，也即QScrollArea的尺寸是隨著用戶鼠標拖動窗口變化而變化的，那么當用戶拖大窗口時，QScrollArea也變得很大，而內部容器還是100X100，這時，滾動條就消失了；如果用戶用鼠標縮小了窗口，QScrollArea也隨之變的很小了，而內部容器還是100X100，QScrollArea就會自動出現滾動條。

記住一句話，除非你在程序運行時修改了內部容器的大小，否則，內部容器將一直保持它初始的大小。那么

?

?

下面講如何控制滾動條何時出現？

有了上面的分析，我們已經知道了QScrollArea有兩層，QScrollArea本身是個QWidget，它內部又套了一個小QWidget。在默認情況下，內部的這個小QWidget，也即scorllAreaWidgetContents，它的大小總是等于外部QWidget（也即QScrollArea）的大小。除非我們給scorllAreaWidgetContents設置了寬高的最小值，這時，當QScrollArea的寬或高，一旦小于scorllAreaWidgetContents的寬或高，就會出現滾動條。

這個scorllAreaWidgetContents是從哪來的？查看QT自動生成的ui代碼（也即：ui->setupUi(this)函數）可見，它是在QScrollArea構造完成之后，再被new出來的，然后調用了QScrollArea::setWidget()。這一點對于我們編程非常重要，否則一不小心就中了坑，假設我們自己繼承QScrollArea寫了一個新的子類，在子類的構造函數中我們通過QScrollArea::setWidget()設置好了自己的小QWidget，然后在ui中把QScrollArea提升為自己寫的這個子類，這時就扯淡了，我們在子類構造函數中為小QWidget添加的控件都沒有顯示出來，因為QT自作主張，在我們自己的構造函數執行完之后，重新new了小QWidget，并通過setWidget函數設置給了這個子類！這真是太坑了。如果你想通過ui提升的方式來使用自己寫的子類，那么請你在ui拖入一個Frame容器或者widget容器等等進行提升，反正不要用拖入的QScrollArea容器進行提升。如果你非得想用QScrollArea容器進行提升，那么你想在QScrollArea的內部容器中添加控件時，請不要把添加控件的代碼寫在QScrollArea子類的構造函數中。

下面繼續研究滾動條問題。

直接看例子，我給scorllAreaWidgetContents成員設置寬高最小值為500*1000，這么高的scorllAreaWidgetContents，顯然QScrollArea在高度上是無法容納下的。實際上，看效果發現，還沒有運行程序，就已經有滾動條了

我們運行一下程序，然后把窗口縮小，看看是不是當窗口<scorllAreaWidgetContents最小值500*1000時，會自動出現水平滾動條。看下圖發現，并沒有出現我們期望的效果。

原因就是，水平滾動條，只有當QScrollArea<內部的QWidget時，才會出現，顯然上圖中，QScrollArea雖然沒顯示全，但是QScrollArea的寬度仍然保持原值，只是被遮住了而已。要想使QScrollArea的寬度變小，要么通過程序直接修改，要么通過設置布局，使QScrollArea的寬度隨窗體的寬度減小而減小。我們這里就簡單一點，直接給窗體設置網格布局，使得QScrollArea的大小受窗體大小驅動。運行起來，再看下效果：

再補充幾點：

內部的小QWidget與QScrollArea的關系，就像是給QScrollArea設置了網格布局，然后把小QWidget放進了這個布局中，如果給小QWidget設置的最大寬高<QScrollArea的實時大小，那么QScrollArea會顯示出空白，而空白部分是無法放置/顯示我們自己拖入的控件的，如下圖：

如果我們不給小QWidget設置寬高最大值，那么它的寬width將滿足：

它的高也有與之相同的規律。

知道了原理，不論是用UI設計器來做界面，還是直接用代碼來做界面，就都不是問題了。

?

技巧：

通過上述操作，我們知道了，我們可以通過設置內部小QWidget的寬、高最小值，來讓外部QScrollArea適時的出現滾動條，那么到底把小QWidget的寬、高最小值設置為多少合適呢？

答案是顯然的：把小QWidget的寬、高最小值設置為剛好能容納內部的按鈕等控件，這樣看起來最舒服。難道我要先計算或者觀察一下按鈕等控件占用的面積之后，才能去設置小QWidget的寬、高最小值嗎？

這樣做太費勁了，我們肯定不會去這樣做，除非是用ui設計師拖控件時，所見即所得，才無需計算小QWidget的寬、高最小值。用代碼寫界面時，最好的做法是：

1、向小QWidget中添加按鈕等控件時，隨著添加的按鈕增多，小QWidget自動變大，顯然用QGridLayout來做就能實現這個自動增大這個需求。自動增大也只是出現創建內部容器階段，一旦內部容器和布局、布局內的控件都創建和添加完畢，后續即使再向布局中添加控件，內部容器也不會自動增大了，這時只有靠setGeometry手動修改內部容器的大小了。

2、添加完控件后，手動調用一下adjustSize函數，該函數會根據所有子控件的大小之和，來調整父控件的大小。

步驟如下：先在ui中拖入一個QScrollArea控件，名字為scrollArea，然后添加代碼：
?

MainWindow::MainWindow(QWidget *parent) :QMainWindow(parent),ui(new Ui::MainWindow) {ui->setupUi(this);QGridLayout *pLayout = new QGridLayout();//網格布局for(int i = 0; i < 100; i++){QPushButton *pBtn = new QPushButton();pBtn->setText(QString("按鈕%1").arg(i));pBtn->setMinimumSize(QSize(60,30)); //width heightpLayout->addWidget(pBtn);//把按鈕添加到布局控件中}ui->scrollArea->widget()->setLayout(pLayout);//把布局放置到QScrollArea的內部QWidget中 }

?根據原著者的描述，轉載人補充如下代碼，展示在不使用ui拖拽的情況下，實現滾動條：

#include "mainwindow.h" #include "ui_mainwindow.h" #include <QHBoxLayout> #include <QPushButton> #include <QScrollArea>MainWindow::MainWindow(QWidget *parent) :QMainWindow(parent),ui(new Ui::MainWindow) {ui->setupUi(this);QScrollArea * scrollArea = new QScrollArea(this);QWidget * pWgt = new QWidget;QHBoxLayout *pLayout = new QHBoxLayout();//網格布局for(int i = 0; i < 100; i++){QPushButton *pBtn = new QPushButton();pBtn->setText(QString("按鈕%1").arg(i));pBtn->setMinimumSize(QSize(60,30)); //width heightpLayout->addWidget(pBtn);//把按鈕添加到布局控件中}pWgt->setLayout(pLayout);//這一句setWidget必須放在pWgt里面的內容都準備完畢之后，否則顯示有問題scrollArea->setWidget(pWgt);setCentralWidget(scrollArea); }MainWindow::~MainWindow() {delete ui; }

?

總結

以上是生活随笔為你收集整理的QT的自动滚动区QScrollArea的用法，图文详解的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。