QProperty Class

멤버 함수 문서

[default] QProperty::QProperty()

T의 기본 생성된 인스턴스를 가진 속성을 생성합니다.

[explicit] template <typename Functor> QProperty::QProperty(Functor &&f)

지정된 바인딩 표현식 f 에 연결된 속성을 생성합니다. 이 속성의 값은 새로운 바인딩을 평가한 결과로 설정됩니다. 바인딩의 종속성이 변경될 때마다 바인딩이 재평가되며, 이에 따라 속성의 값도 업데이트됩니다.

[explicit implicit] QProperty::QProperty(T &&initialValue)

Move-Constructs는 제공된 initialValue 를 사용하여 속성을 생성합니다.

[explicit] QProperty::QProperty(const QPropertyBinding<T> &binding)

지정된 binding 표현식과 연결된 속성을 생성합니다. 이 속성의 값은 새 바인딩을 평가한 결과로 설정됩니다. 바인딩의 종속성이 변경될 때마다 바인딩이 다시 평가되며, 이에 따라 속성의 값이 업데이트됩니다.

[explicit implicit] QProperty::QProperty(const T &initialValue)

지정된 ` initialValue`을 사용하여 속성을 생성합니다.

[default] QProperty::~QProperty()

해당 속성을 삭제합니다.

[since 6.2] template <typename Functor> QPropertyNotifier QProperty::addNotifier(Functor f)

지정된 펑터 f 를 속성 값이 변경될 때마다 호출되는 콜백으로 등록합니다.

f 콜백은 매개변수가 없는 일반 호출 연산자 () 를 갖는 타입이어야 합니다. 즉, C++ 람다 표현식, std::function 또는 호출 연산자가 있는 사용자 정의 구조체도 제공할 수 있습니다.

반환된 속성 변경 핸들러 객체는 구독 상태를 추적합니다. 이 객체가 범위 밖으로 나가면 콜백의 구독이 해제됩니다.

반환되는 객체가 템플릿이 아니기 때문에, 이 메서드는 경우에 따라 onValueChanged()보다 사용하기 더 쉽습니다. 따라서 클래스의 멤버로 저장하는 등 더 쉽게 관리할 수 있습니다.

이 함수는 Qt 6.2에서 도입되었습니다.

onValueChanged() 및 subscribe()도 참조하십시오 .

QPropertyBinding<T> QProperty::binding() const

이 속성과 연결된 바인딩 표현식을 반환합니다. 해당 연결이 존재하지 않으면 기본 생성된 QPropertyBinding<T>가 반환됩니다.

setBinding()도 참조하십시오 .

template <typename Functor> QPropertyChangeHandler<Functor> QProperty::onValueChanged(Functor f)

주어진 펑터 f 를 속성의 값이 변경될 때마다 호출될 콜백으로 등록합니다. 값이 변경될 때마다 컨텍스트에 따라 핸들러가 즉시 호출되거나 지연되어 호출됩니다.

콜백 f 은 매개변수가 없는 일반 호출 연산자 () 를 갖는 유형이어야 합니다. 즉, C++ 람다 표현식, std::function 또는 호출 연산자가 있는 사용자 정의 구조체도 제공할 수 있습니다.

반환된 속성 변경 핸들러 객체는 등록 상태를 추적합니다. 이 객체가 범위 밖으로 나가면 콜백이 등록 해제됩니다.

QPropertyBinding<T> QProperty::setBinding(const QPropertyBinding<T> &newBinding)

이 속성의 값을 제공된 newBinding 표현식과 연결하고, 이전에 연결된 바인딩을 반환합니다. 속성의 값은 새로운 바인딩을 평가한 결과로 설정됩니다. 바인딩의 종속성이 변경될 때마다 바인딩이 재평가되며, 속성의 값은 그에 따라 업데이트됩니다.

binding()도 참조하십시오 .

[since 6.0] template <typename Functor> QPropertyBinding<T> QProperty::setBinding(Functor f)

이 속성의 값을 제공된 펑터 f 와 연관시키고, 이전에 연관되었던 바인딩을 반환합니다. 속성의 값은 새로운 바인딩을 평가한 결과로 설정됩니다. 바인딩의 종속성이 변경될 때마다 바인딩이 재평가되며, 속성의 값도 그에 따라 업데이트됩니다.

이 함수는 Qt 6.0에서 도입되었습니다.

‘속성 바인딩 구성’항목도 참조하십시오 .

bool QProperty::setBinding(const QUntypedPropertyBinding &newBinding)

이 속성의 값을 제공된 newBinding 표현식과 연결합니다. 속성의 값은 새로운 바인딩을 평가한 결과로 설정됩니다. 바인딩의 종속성이 변경될 때마다 바인딩이 재평가되며, 이에 따라 속성의 값이 업데이트됩니다.

이 속성의 유형이 바인딩 함수가 반환하는 유형과 동일한 경우 true를 반환하고, 그렇지 않은 경우 false를 반환합니다.

이 속성에 ` newValue `를 할당하고, 해당 속성에 바인딩이 설정되어 있는 경우 이를 제거합니다.

[since 6.0] template <typename Functor> QPropertyChangeHandler<Functor> QProperty::subscribe(Functor f)

주어진 펑터 f 를 콜백으로 등록하여, 해당 속성의 값이 변경될 때마다 즉시 호출되도록 합니다. 값이 변경될 때마다 컨텍스트에 따라 핸들러가 즉시 호출되거나 지연되어 호출됩니다.

f 콜백은 복사 가능한 유형이어야 하며, 매개변수가 없는 단순한 호출 연산자()를 가져야 합니다. 즉, C++ 람다 표현식, std::function 또는 호출 연산자가 있는 사용자 정의 구조체도 제공할 수 있습니다.

반환된 속성 변경 핸들러 객체는 구독 상태를 추적합니다. 이 객체가 범위 밖으로 나가면 콜백 구독이 해제됩니다.

이 함수는 Qt 6.0에서 도입되었습니다.

QPropertyBinding<T> QProperty::takeBinding()

이 속성에서 바인딩 표현식을 분리하고 해당 표현식을 반환합니다. 이 함수를 호출한 후에는, 속성의 값은 새로운 값을 할당하거나 새로운 바인딩이 설정된 경우에만 변경됩니다.

QProperty<T>::parameter_type QProperty::value() const

속성의 값을 반환합니다. 이 함수는 값을 반환하기 전에, 해당 속성에 연결된 바인딩 표현식을 평가할 수 있습니다.

setValue()도 참조하십시오 .

이 속성에 ` newValue `를 할당하고, 이 ` QProperty`에 대한 참조를 반환합니다.