【Qt 为控件设置固定宽度的工具提示（ToolTip）】

// 创建带有固定宽度的 HTML 工具提示
QString toolTipText = "这是一个很长的工具提示文本，需要根据固定宽度进行换行处理，以确保在工具提示中显示美观。";
QString htmlToolTip = QString("<div style='width: 200px;'>%1</div>").arg(toolTipText);

// 设置到控件
ui->yourWidget->setToolTip(htmlToolTip);

// 创建带有样式的 HTML 工具提示
QString toolTipText = "这是一个很长的工具提示文本，需要根据固定宽度进行换行处理。";
QString htmlToolTip = QString("<div class='tooltip-style'>%1</div>").arg(toolTipText);

// 设置到控件
ui->yourWidget->setToolTip(htmlToolTip);

// 如果需要，可以在应用程序中设置全局工具提示样式
qApp->setStyleSheet(
    "QToolTip {"
    "   background-color: #ffffe0;"
    "   color: black;"
    "   border: 1px solid black;"
    "   padding: 3px;"
    "   opacity: 230;"
    "}"
    ".tooltip-style {"
    "   width: 200px;"
    "}"
);

// 获取工具提示的字体（通常是系统默认字体）
QFont toolTipFont = QToolTip::font();

// 使用前面提到的换行函数处理文本
QString wrappedText = wrapText(toolTipText, toolTipFont, 200); // 200像素宽度

// 设置到控件
ui->yourWidget->setToolTip(wrappedText);

// 创建富文本工具提示
QString toolTipText = "这是一个很长的工具提示文本，需要根据固定宽度进行换行处理。";
QString richToolTip = QString("<p style='width: 200px; margin: 0px;'>%1</p>").arg(toolTipText);

// 设置到控件
ui->yourWidget->setToolTip(richToolTip);

QString createWrappedToolTip(const QString& text, int widthPx = 200)
{
    // 使用 HTML div 设置固定宽度
    return QString("<div style='width: %1px;'>%2</div>").arg(widthPx).arg(text);
}

// 使用示例
void setupToolTips()
{
    QString longText = "这是一个非常长的工具提示文本，需要在固定宽度的工具提示框中正确显示，避免超出屏幕或显示不完整。";
    
    // 设置固定宽度为250像素的工具提示
    ui->widget1->setToolTip(createWrappedToolTip(longText, 250));
    
    // 使用默认宽度(200像素)
    ui->widget2->setToolTip(createWrappedToolTip("较短的提示文本"));
}

#include <QTextDocument>

QString escapedText = Qt::escape(yourText); // Qt 5
// 或者
QString escapedText = yourText.toHtmlEscaped(); // Qt 5 及更新版本

// 设置固定宽度工具提示的推荐方法
ui->yourWidget->setToolTip(
    QString("<div style='width: 200px;'>%1</div>")
        .arg("您的工具提示文本内容")
);