打造原生感 Qt 桌面應用（三）：自定義 QStyle 深度實作

兩種自定義外觀的路徑

1. 重寫 paintEvent()：針對單一組件類別微調繪製，工作量大但精準可控。
2. 繼承 QStyle/QProxyStyle：統一整個應用的風格，適合主題級定製。

⚠️ QStyle 極其複雜 (百餘虛函數)，非必要勿深入。Qt 4.6+ 提供 QProxyStyle 代理模式，僅覆寫關心的函數，其餘委託給系統風格，大幅降低複雜度。

路徑一：重寫 paintEvent() — 以 QPushButton 為例

目標

自繪按鈕，點擊時呈現凹陷效果。

步驟

1. 繼承 QPushButton。
2. 覆寫 paintEvent(QPaintEvent*)。
3. 構造 QStyleOptionButton 傳遞繪製參數。
4. 呼叫 style()->drawControl(...) 讓系統風格按我們參數繪製。

核心代碼

void MyPushButton::paintEvent(QPaintEvent*)
{
    QStyleOptionButton option;
    option.initFrom(this);                    // 以 widget 狀態初始化
    option.state |= isDown() ? QStyle::State_Sunken : QStyle::State_Raised; // 按下/彈起
    if (isDefault()) option.features |= QStyleOptionButton::DefaultButton; // 預設按鈕特徵
    option.text = text();
    option.icon = icon();

    QPainter painter(this);
    style()->drawControl(QStyle::CE_PushButton, &option, &painter, this);
}

關鍵點解析

• QStyleOptionButton：承載繪製所需所有資料 (幾何、狀態、文字、圖示、特徵)。
• option.state 為 QFlags (位圖)，**必須用 |= 而非 =**，否則會清除其他狀態位 (如焦點、啟用、滑鼠懸停等)。
• drawControl(ControlElement, QStyleOption*, QPainter*, QWidget*)：通用組件繪製入口。CE_PushButton 代表按鈕整體。
• 此法實為「參數化系統繪製」，非像素級手繪，保留平台風格基因。

路徑二：繼承 QProxyStyle — 全域風格定製

簡易範例：強制所有按鈕文字顯示 "fixed"

class MyProxyStyle : public QProxyStyle
{
public:
    void drawControl(ControlElement element, const QStyleOption* option,
                     QPainter* painter, const QWidget* widget) const override
    {
        if (element == QStyle::CE_PushButtonLabel) {
            painter->drawText(option->rect, "fixed"); // 忽略原本文字
        } else {
            QProxyStyle::drawControl(element, option, painter, widget); // 委託系統
        }
    }
};

啟用自定義風格

int main(int argc, char** argv)
{
    QApplication app(argc, argv);
    app.setStyle(new MyProxyStyle); // 應用啟動前設定
    MainWindow w;
    w.show();
    return app.exec();
}

進階覆寫策略

實戰建議

1. 優先用 QSS (下篇主題) 解決 80% 外觀需求，無法覆蓋的行為邏輯再用 QProxyStyle。
2. 最小化覆寫：僅覆寫必要函數，其餘委託基類，減少維護負擔與相容性風險。
3. 測試矩陣：Windows (Vista/7/10/11)、macOS、GNOME (Adwaita)、KDE (Breeze) 至少各測一版本。
4. 參考原始碼：Qt 內建風格 (qwindowsstyle.cpp, qmacstyle.mm 等) 是最佳範例與文檔。

結語

自定義 QStyle 是 Qt 視覺定製的核武器，門檻高但威力大。掌握 QStyleOption 資料流向與 QProxyStyle 代理模式，即可在保留跨平台優勢的前提下，精準注入品牌風格或平台適配細節。