한국어
Qt
 

Qt 6 Qt 6의 C++ 프로퍼티 바인딩 예제

makersweb 2021.11.01 21:59 조회 수 : 845

이 게시물에서는 Qt 6.0에 추가된 C++ 바인딩 기능을 잘 사용하는 방법을 설명하고 간단한 예제를 제공한다.

다음의 간단한 클래스와 같이 QBindable<int>를 반환하는 새로운 bindableX() 메서드를 추가하고 Q_PROPERTY 매크로에서 메타 개체 시스템에 이에 대해 알렸다. Qt 6.0부터 BINDABLE 을 사용하여 바인딩 가능한 속성을 지정할 수 있다.

myobject.h

#include <QObject>

class MyObject : public QObject
{
    Q_OBJECT
    Q_PROPERTY(int x READ x WRITE setX BINDABLE bindableX)

public:
    explicit MyObject(QObject *parent = nullptr);
    int x() { return xData; }
    void setX(int x) { xData = x; }
    QBindable<int> bindableX() { return &xData; }

signals:
    void xChanged();

private:
    // Qt5에서는 아래 줄이 "int xData;" 였다.
    Q_OBJECT_BINDABLE_PROPERTY(MyObject, int, xData, &MyObject::xChanged)

};

Qt 6 이전에 setter의 구현은 새 값과 기존 값을 비교하여 다를 경우에만 클래스 멤버변수를 업데이트하고 시그널을 방출했다. Qt 6.0 이상에서는 이 동일한 기능이 한 줄만 포함하도록 단순화되었다. 현재 값과 새 값에 대한 비교가 API 코드에서 수행되기 때문이다.

바인딩을 설정하거나 알림을 등록할 수 있다. 예를 들어 다음의 예제처럼 setBinding() 호출하여 MyObject의 x 속성에 대한 바인딩을 설정한다. 또 onValueChanged() 를 통해 속성 값이 변경될 때마다 호출되는 콜백을 등록할 수 있다. 여기서는 myobject1의 x 값이 변경되면 myobject2에 설정된 바인딩을 제거하도록했다.

main.cpp

...
#include "myobject.h"

int main(int argc, char *argv[])
{
...
    MyObject myobject1;
    MyObject myobject2;

    // 'x'프로퍼티 값 설정.
    myobject1.setX(50);

    // myobject1 의 'x'프로퍼티를 myobject2 의 'x'프로퍼티에 바인딩.
    myobject2.bindableX().setBinding([&](){
        return myobject1.x() + 50;
    });

    auto h1 = myobject1.bindableX().onValueChanged([&](){
        qDebug() << "myobject1 'x' Changed.";
        qDebug() << myobject2.bindableX().hasBinding();

        // 현재 설정된 바인딩을 제거.
        myobject2.bindableX().takeBinding();

        qDebug() << myobject2.bindableX().hasBinding();
    });

    QQmlApplicationEngine engine;
...
    // QML에 노출시킴.
    engine.rootContext()->setContextProperty("myobject1", &myobject1);
    engine.rootContext()->setContextProperty("myobject2", &myobject2);
...
}

Rectangle 의 width 는 myobject2 의 x 에 바인딩 되었으며 height 은 width 와 같다. Rectangle 영역을 마우스로 클릭하면 myobject1 의 x 값을 10 증가 시키도록했다.

main.qml

...
    Rectangle {
        width: myobject2.x // myobject2 의 'x'프로퍼티 바인딩.
        height: width

        border.width: 1

        anchors.centerIn: parent

        onWidthChanged: console.log("width:", width)
        onHeightChanged: console.log("height:", height)

        MouseArea {
            anchors.fill: parent
            onClicked: {
                myobject1.x += 10 // myobject1의 'x'값을 10 증가시킴.
            }
        }
    }
...

사각형을 클릭하면 시각적으로 어떻게 변하는지 알 수 있으며 콘솔 출력은 다음과 같다

qml: width: 100
qml: height: 100
qml: width: 110
qml: height: 110 
true 
myobject1 'x' Changed. 
false
번호 제목 글쓴이 날짜 조회 수
공지 Qt프로그래밍(QtQuick) Beginner를 위한 글 읽는 순서 운영자 2019.01.05 85343
156 단일 인스턴스 Qt 응용 프로그램(Single-instance Application) makersweb 2022.06.23 693
155 Qt로 작성된 iOS 앱에서 시리얼 통신 file makersweb 2022.04.30 807
154 VirtualKeyboard 스타일 커스터 마이징 makersweb 2022.03.13 448
153 성능 고려 및 제안 사항 makersweb 2022.03.07 493
152 Binding 타입으로 객체 속성 간 묶기 makersweb 2022.03.04 404
151 Qt Bluetooth Low Energy 개요 makersweb 2022.02.13 650
150 Qt Android 앱에 AdMob 배너달기 file makersweb 2021.12.04 385
» Qt 6의 C++ 프로퍼티 바인딩 예제 makersweb 2021.11.01 845
148 QML에서 앵커(anchors)로 위치 지정 file makersweb 2021.10.05 3700
147 안드로이드용 Qt 6.2 makersweb 2021.10.02 490
146 Qt 응용프로그램에서 PDF 문서 렌더링 file makersweb 2021.09.23 652
145 QML에서 Websocket 서버와 통신 file makersweb 2021.09.18 806
144 QML 코딩 규칙 makersweb 2021.09.05 3174
143 QML 에서 QR코드 생성 file makersweb 2021.08.20 882
142 앱을 종료할 때 QML 바인딩 오류를 피하는 방법 makersweb 2021.08.08 487
141 Qt 응용프로그램에서 Lottie Animation사용 file makersweb 2021.05.30 867
140 싱글 샷(Single-Shot) 시그널/슬롯 연결 makersweb 2021.05.12 740
139 응용프로그램 자동실행 설정 (on Windows) makersweb 2021.05.08 555
138 Qt 6 에서 프로퍼티 바인딩 makersweb 2021.04.03 761
137 QML과 JavaScript 의 숫자 관련 내장된 함수 makersweb 2021.03.28 1352