快捷導(dǎo)航

Qt框架中Q_PROPERTY宏的使用

更新時(shí)間：2025年11月04日 09:01:17 作者：愛(ài)吃巧克力的程序媛

Q_PROPERTY是Qt框架中的一個(gè)重要宏,用于在QObject派生類(lèi)中聲明屬性,使得這些屬性可以在QML中直接訪問(wèn)和修改,本文就來(lái)介紹一下Q_PROPERTY宏的使用,感興趣的可以了解一下

Q_PROPERTY 語(yǔ)法結(jié)構(gòu)

Q_PROPERTY(type name READ getFunction [WRITE setFunction] [NOTIFY signal] [OTHER options])

分解解釋您的代碼中的 Q_PROPERTY

1. 顯示圖像屬性

Q_PROPERTY(QImage displayImage READ displayImage NOTIFY imageChanged)

類(lèi)型: QImage
名稱: displayImage
READ: displayImage() - 讀取函數(shù)
NOTIFY: imageChanged - 變化信號(hào)
作用: 在 QML 中可以通過(guò) imageProcessor.displayImage 訪問(wèn)當(dāng)前顯示的圖像

2. 顏色屬性

Q_PROPERTY(QColor currentColor READ currentColor WRITE setCurrentColor NOTIFY currentColorChanged)

類(lèi)型: QColor
名稱: currentColor
READ: currentColor() - 讀取函數(shù)
WRITE: setCurrentColor() - 寫(xiě)入函數(shù)
NOTIFY: currentColorChanged - 變化信號(hào)
作用: 在 QML 中可以讀取和修改當(dāng)前顏色

3. 字體大小屬性

Q_PROPERTY(int currentFontSize READ currentFontSize WRITE setCurrentFontSize NOTIFY currentFontSizeChanged)

類(lèi)型: int
名稱: currentFontSize
READ: currentFontSize() - 讀取函數(shù)
WRITE: setCurrentFontSize() - 寫(xiě)入函數(shù)
NOTIFY: currentFontSizeChanged - 變化信號(hào)
作用: 在 QML 中可以讀取和修改字體大小

4. 工具屬性

Q_PROPERTY(QString currentTool READ currentTool WRITE setCurrentTool NOTIFY currentToolChanged)

類(lèi)型: QString
名稱: currentTool
READ: currentTool() - 讀取函數(shù)
WRITE: setCurrentTool() - 寫(xiě)入函數(shù)
NOTIFY: currentToolChanged - 變化信號(hào)
作用: 在 QML 中可以讀取和修改當(dāng)前使用的工具

在 QML 中的使用方式

讀取屬性

// 讀取顏色
var color = imageProcessor.currentColor

// 讀取字體大小
var size = imageProcessor.currentFontSize

// 讀取工具類(lèi)型
var tool = imageProcessor.currentTool

修改屬性

// 修改顏色
imageProcessor.currentColor = "blue"

// 修改字體大小
imageProcessor.currentFontSize = 30

// 修改工具
imageProcessor.currentTool = "circle"

綁定屬性

Rectangle {
    color: imageProcessor.currentColor  // 自動(dòng)綁定，顏色變化時(shí)自動(dòng)更新
}

Label {
    text: "字體大小: " + imageProcessor.currentFontSize  // 自動(dòng)更新
}

Button {
    text: imageProcessor.currentTool === "rectangle" ? "矩形工具" : "其他工具"
}

響應(yīng)屬性變化信號(hào)

ImageProcessor {
    onCurrentColorChanged: {
        console.log("顏色已改變?yōu)?", currentColor)
    }
    
    onCurrentToolChanged: {
        console.log("工具已切換為:", currentTool)
    }
    
    onImageChanged: {
        console.log("圖像已更新")
    }
}

完整的 C++ 實(shí)現(xiàn)示例

// 頭文件中的聲明
class ImageProcessor : public QObject
{
    Q_OBJECT
    Q_PROPERTY(QImage displayImage READ displayImage NOTIFY imageChanged)
    Q_PROPERTY(QColor currentColor READ currentColor WRITE setCurrentColor NOTIFY currentColorChanged)
    Q_PROPERTY(int currentFontSize READ currentFontSize WRITE setCurrentFontSize NOTIFY currentFontSizeChanged)
    Q_PROPERTY(QString currentTool READ currentTool WRITE setCurrentTool NOTIFY currentToolChanged)

public:
    // READ 函數(shù)
    QImage displayImage() const { return m_displayImage; }
    QColor currentColor() const { return m_currentColor; }
    int currentFontSize() const { return m_currentFontSize; }
    QString currentTool() const { return m_currentTool; }

    // WRITE 函數(shù)
    void setCurrentColor(const QColor &color) {
        if (m_currentColor != color) {
            m_currentColor = color;
            emit currentColorChanged();
        }
    }
    
    void setCurrentFontSize(int size) {
        if (m_currentFontSize != size) {
            m_currentFontSize = size;
            emit currentFontSizeChanged();
        }
    }
    
    void setCurrentTool(const QString &tool) {
        if (m_currentTool != tool) {
            m_currentTool = tool;
            emit currentToolChanged();
        }
    }

signals:
    // NOTIFY 信號(hào)
    void imageChanged();
    void currentColorChanged();
    void currentFontSizeChanged();
    void currentToolChanged();

private:
    QImage m_displayImage;
    QColor m_currentColor;
    int m_currentFontSize;
    QString m_currentTool;
};