如何在Wayland平台避免Qt::Popup超出屏幕边界？

方案1：利用Qt内置样式API计算相对位置 #

Qt的样式系统提供了无需全局坐标的位置计算能力，基于父窗口的可用空间自动调整Popup位置：

• 先获取选中文本在父窗口内的局部矩形（比如通过文本控件的selectedTextRect()接口）
• 调用QStyle::alignedRect()，传入父窗口的内容区域、对齐规则和Popup的尺寸，让样式引擎计算不超出父窗口的候选位置
• 再针对贴合文本的需求微调位置，最后检查边界并反向偏移

示例代码：

// 假设textEdit是父窗口内的文本控件
QRect textRect = textEdit->selectedTextRect();
QSize popupSize = popupWidget->sizeHint();
QStyleOption opt;
opt.initFrom(textEdit);

// 先计算贴合文本下方的初始位置
QRect targetRect = textRect.translated(0, textRect.height());
// 用样式API确保不超出父窗口内容区域
QRect alignedRect = textEdit->style()->alignedRect(
    opt.direction,
    Qt::AlignLeft | Qt::AlignTop,
    popupSize,
    textEdit->contentsRect()
);
alignedRect.moveTopLeft(targetRect.topLeft());

// 手动修正超出边界的情况
if (alignedRect.right() > textEdit->contentsRect().right()) {
    alignedRect.moveRight(textEdit->contentsRect().right());
}
if (alignedRect.bottom() > textEdit->contentsRect().bottom()) {
    alignedRect.moveBottom(textRect.top());
}

popupWidget->move(alignedRect.topLeft());

方案2：切换到Qt Quick的Popup组件 #

Qt Quick的Popup原生支持自动位置调整，完全适配Wayland的安全模型：

• 通过placement属性设置默认贴合方向（如Popup.Bottom）
• 开启autoPosition后，组件会自动检测父项的可用空间，空间不足时自动切换到反向位置
• 直接通过锚点绑定选中文本的矩形，无需手动计算

示例QML代码：

TextEdit {
    id: textEdit
    // 文本控件逻辑...

    Popup {
        id: textPopup
        autoPosition: true
        placement: Popup.Bottom
        anchors.left: textEdit.selectedTextRect.left
        anchors.top: textEdit.selectedTextRect.bottom
        // Popup内容...
    }
}

方案3：基于父窗口相对坐标手动计算 #

完全依赖父窗口的局部几何信息，不涉及全局坐标：

• 获取父窗口的contentsRect()作为可用边界
• 计算Popup默认位置（文本下方/右侧）相对于父窗口的坐标
• 检查Popup是否超出父窗口右/下边界，超出则将对应轴的坐标调整为边界减去Popup尺寸

核心逻辑示例：

QRect parentContent = parentWidget()->contentsRect();
QRect textRect = getSelectedTextRect(); // 自定义方法获取文本局部矩形
QRect popupRect(0, 0, popupWidth, popupHeight);

// 默认贴在文本下方左侧
popupRect.moveTopLeft(textRect.bottomLeft());

// 右边界超出则左移
if (popupRect.right() > parentContent.right()) {
    popupRect.moveRight(parentContent.right());
}
// 下边界超出则移到文本上方
if (popupRect.bottom() > parentContent.bottom()) {
    popupRect.moveBottom(textRect.top());
}

popupWidget->move(popupRect.topLeft());

方案4：借助QScreen获取屏幕可用区域（兼容性依赖 compositor） #

部分Wayland compositor支持QScreen::availableGeometry()获取屏幕可用区域，结合父窗口的几何信息间接适配：

QScreen* screen = parentWidget()->screen();
if (!screen) return;

QRect screenAvailable = screen->availableGeometry();
QRect parentGlobal = parentWidget()->frameGeometry();
// 计算父窗口在屏幕内的有效可用区域
QRect validArea = parentGlobal.intersected(screenAvailable);

// 基于validArea计算Popup位置，逻辑同方案3

注意：该方案依赖 compositor 的实现，部分环境可能返回无效值，需做 fallback 处理。

内容的提问来源于stack exchange，提问作者MadRunner