Qt 中 如何获取当前界面上正在显示的所有按钮控件，并过滤掉被遮档控件，并按照控件相对位置，放置在一个二维数组中， 包含必须要头文件

在Qt中，要获取当前界面上所有按钮控件，并过滤掉被遮挡的控件，然后按照控件的相对位置放置在二维数组中，可以使用QStackedWidget或QWidget的子类作为容器，然后通过遍历子控件的方式获取。以下是一个简单的实现示例：

首先，包含必须的头文件：

#include <QWidget>
#include <QButtonGroup>
#include <QVector>
#include <QList>
#include <QPoint>
#include <QRect>
#include <QStackedWidget>

然后，可以通过遍历QWidget的所有子控件来获取按钮控件。这里使用`QStackedWidget`作为示例界面容器，获取其所有子控件，并将按钮类型的控件存储在一个二维数组（实际使用`QVector`或`QList`）中。以下是函数的伪代码：

void getButtonsInStackedWidget(QStackedWidget* stackedWidget, QVector<QVector<QWidget*>>& buttonArray) {
    if (!stackedWidget) return;

    // 遍历所有子控件
    const auto children = stackedWidget->children();
    for (QWidget* child : children) {
        // 检查控件是否为按钮类型
        if (qobject_cast<QAbstractButton*>(child)) {
            // 检查按钮是否可见
            if (child->isVisible()) {
                // 检查按钮是否被遮挡（需要自定义函数或逻辑来判断）
                bool isObstructed = checkIfObstructed(child);
                if (!isObstructed) {
                    // 获取按钮的位置
                    QPoint buttonPos = child->mapToGlobal(QPoint(0, 0));
                    // 根据位置将按钮添加到二维数组中
                    buttonArray[buttonPos.y()][buttonPos.x()] = child;
                }
            }
        }
    }
}

bool checkIfObstructed(QWidget* widget) {
    // 自定义逻辑来判断控件是否被遮挡
    // ...
    return false; // 假设没有控件被遮挡
}

在使用上述函数之前，你需要创建一个`QVector`二维数组，用来存放按钮控件。这个数组可以基于界面上控件的最大可能数量和层级进行初始化。

请注意，这个方法假设你能够通过`mapToGlobal`方法正确地获取到控件的全局位置，并且能够将这些位置转换到一个二维数组的索引中。此外，判断控件是否被遮挡的逻辑（`checkIfObstructed`函数）需要根据实际情况编写，Qt本身并没有直接提供这样的函数。