qdockwidget的全面解析

一、QDockWidget是什麼？

QDockWidget是Qt GUI類庫中的一個窗口部件，它是一個可抽取（dockable）的窗口，可自由地停留在主窗口的四周或浮動在主窗口之外。它通常用於實現由多個子窗口組成的主窗口，並且可以快速地停靠到主窗口的周圍，提高應用程序的易用性。

下面是一個簡單的示例代碼，展示如何創建一個QDockWidget，以及如何將其停靠在主窗口的左側：

QDockWidget *dock = new QDockWidget(tr("Dockable"), this);
dock->setAllowedAreas(Qt::LeftDockWidgetArea | Qt::RightDockWidgetArea);
QTextEdit *editor = new QTextEdit(dock);
dock->setWidget(editor);
addDockWidget(Qt::LeftDockWidgetArea, dock);

上面的代碼中，首先創建了一個QDockWidget對象，並且設置了它可以停留在主窗口的左側或右側，然後將一個QTextEdit對象設置為該QDockWidget的子部件，並將該QDockWidget添加到主窗口的左側（LeftDockWidgetArea）。

二、QDockWidget的主要特性

1. 可停靠、可浮動

QDockWidget可以通過滑鼠拖動的方式停靠在主窗口的四周，也可以浮動到主窗口之外。通過setAllowedAreas()函數可以控制QDockWidget可以停靠的區域。

2. 可關閉、可隱藏

QDockWidget可以通過滑鼠右鍵菜單或者setFeatures()函數來設置是否可以關閉和隱藏。

3. 可設置標題和圖標

QDockWidget可以通過setTitle()和setWindowTitle()函數來設置標題，通過setWindowIcon()函數來設置圖標。

4. 可以懸浮

QDockWidget可以通過setFloating()函數來設置是否可以懸浮。

5. 可以設置大小策略

QDockWidget可以通過setSizePolicy()函數設置水平和垂直方向的大小策略。

三、QDockWidget的使用注意事項

1. 容器空間的設置

當QDockWidget和其他QWidget（比如QFrame、QLayout等）一起使用時，必須保證這些QWidget的容器空間（容器的大小和位置）是正確的。要使用setWidget()函數將QWidget添加到QDockWidget中，或者直接使用構造函數初始化QDockWidget，但是需要注意QWidget的大小和位置。

2. 可停靠區域的控制

QDockWidget可以通過setAllowedAreas()函數來控制停靠的區域。在設置之前，必須先調用mainWindow()函數獲取主窗口對象，然後利用主窗口的setDockOptions()函數設置最大化和自動擴展區域。同時要根據實際情況設置QDockWidget和其他QMainWindow的layout，從而保證它們的位置和大小是正確的。

3. 內存泄露問題

當QDockWidget被從主窗口中移除時，需要通過delete函數顯式地銷毀它。如果沒有顯式銷毀，可能會導致內存泄露問題。

四、完整示例代碼

下面是一個完整的示例代碼，展示了如何創建帶有QDockWidget的主窗口，並將兩個QDockWidget停靠在主窗口的左側和右側：

#include 
#include 
#include 
#include 

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

    QMainWindow mainWindow;
    mainWindow.setWindowTitle("Main Window");

    QDockWidget *leftDock = new QDockWidget("Left Dock", &mainWindow);
    leftDock->setAllowedAreas(Qt::LeftDockWidgetArea | Qt::RightDockWidgetArea);
    QTextEdit *leftText = new QTextEdit(leftDock);
    leftDock->setWidget(leftText);
    mainWindow.addDockWidget(Qt::LeftDockWidgetArea, leftDock);

    QDockWidget *rightDock = new QDockWidget("Right Dock", &mainWindow);
    rightDock->setAllowedAreas(Qt::LeftDockWidgetArea | Qt::RightDockWidgetArea);
    QTextEdit *rightText = new QTextEdit(rightDock);
    rightDock->setWidget(rightText);
    mainWindow.addDockWidget(Qt::RightDockWidgetArea, rightDock);

    mainWindow.show();

    return app.exec();
}