一、概述

在應用程序開發中，為用戶提供有效的在線幫助是提升用戶體驗的重要環節。Qt框架提供了多種方式來為應用程序添加幫助功能，從簡單的工具提示到復雜的幫助文檔系統。

二、工具提示、狀態提示和"What’s This?"幫助

1、工具提示(Tool Tips)

添加工具提示到控件

在Qt中，工具提示可以通過setToolTip()方法為任何QWidget派生類控件設置。例如：

QPushButton *button = new QPushButton("Click Me");
button->setToolTip("This is a button tooltip");

富文本工具提示

工具提示支持HTML格式的富文本，可用于自定義樣式或添加圖片：

label->setToolTip("<b>Warning:</b> <font color='red'>Required field</font>");

全局工具提示設置

修改應用程序的全局工具提示樣式可通過QToolTip類：

QToolTip::setFont(QFont("Arial", 10));
QToolTip::setPalette(QPalette(Qt::lightGray));

延遲顯示控制

調整工具提示顯示/隱藏的延遲時間（毫秒）：

QToolTip::showText(pos, text, nullptr, QRect(), 2000);  // 立即顯示并持續2秒

自定義工具提示窗口

繼承QWidget創建完全自定義的工具提示：

class CustomToolTip : public QWidget {// 實現paintEvent和sizeHint等
};
// 使用QHelpEvent或事件過濾器觸發顯示

禁用工具提示

臨時禁用特定控件的工具提示：

widget->setAttribute(Qt::WA_AlwaysShowToolTips, false);

工具提示與狀態欄聯動

在QMainWindow中，工具提示可同步顯示到狀態欄：

connect(button, &QPushButton::hovered, [this](){statusBar()->showMessage(button->toolTip());
});

注意：工具提示默認在控件獲得焦點時也會顯示，可通過Qt::WA_AlwaysShowToolTips屬性調整行為。

特點：

• 自動顯示黃色背景黑色文字
• 主要用于工具欄按鈕和菜單項
• 如果沒有顯式設置，QAction會使用動作文本作為工具提示

2、狀態提示(Status Tips)

狀態提示是比工具提示稍長的描述性文本，當鼠標懸停在控件上時顯示在狀態欄中。

newAction->setStatusTip(tr("Create a new document"));

3、"What’s This?"幫助

"What’s This?"幫助提供了更詳細的上下文相關幫助，通常通過點擊幫助按鈕或按Shift+F1激活。
使用方法：

// 為控件設置"What's This?"幫助
findButton->setWhatsThis(tr("This button initiates a search for the ""text you entered in the search box."));

三、使用QTextBrowser實現簡單幫助瀏覽器

對于更復雜的幫助系統，可以使用QTextBrowser作為簡單的幫助瀏覽器：

// 創建簡單的幫助瀏覽器
QTextBrowser *helpBrowser = new QTextBrowser;
helpBrowser->setSource(QUrl("help/contents.html"));
helpBrowser->show();

特點：

• 支持HTML格式的幫助文檔
• 可以顯示本地或網絡上的幫助內容
• 支持導航歷史記錄

四、集成Qt Assistant

對于更專業的幫助系統，可以集成Qt Assistant：

// 啟動Qt Assistant顯示幫助文檔
QProcess *assistant = new QProcess;
QStringList args;
args << "-collectionFile" << "myapp.qhc" << "-enableRemoteControl";
assistant->start("assistant", args);// 顯示特定頁面
QByteArray ba;
ba.append("setSource qthelp://myapp/doc/overview.html\n");
assistant->write(ba);

優勢：

• 支持全文搜索
• 提供目錄和索引
• 支持多文檔集合
• 可定制的外觀和行為

五、調用外部瀏覽器

也可以直接調用系統默認的瀏覽器顯示HTML幫助文檔：

// 使用QDesktopServices打開幫助文檔
QDesktopServices::openUrl(QUrl("help/contents.html"));// 或者使用QProcess啟動特定瀏覽器
QProcess::startDetached("firefox", QStringList() << "help/contents.html");