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 ` は、コピー可能であり、引数を持たない単純な `operator()` を持つ型であることが求められます。つまり、C++ のラムダ式、`std::function`、あるいは `operator()` を持つカスタム構造体などを指定することができます。

返されるプロパティ変更ハンドラオブジェクトは、サブスクリプションを追跡します。このオブジェクトがスコープ外になると、コールバックのサブスクリプションは解除されます。

この関数は Qt 6.0 で導入されました。

QPropertyBinding<T> QProperty::takeBinding()

このプロパティからバインディング式を切り離し、それを返します。この関数を呼び出した後、プロパティの値が変更されるのは、新しい値を代入した場合、または新しいバインディングが設定された場合のみとなります。

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

プロパティの値を返します。値を返す前に、このプロパティに紐付けられているバインディング式が評価される場合があります。

setValue()も参照してください 。

このプロパティにnewValue を割り当て、このQProperty への参照を返します。