QModelRoleData Class
QModelRoleData クラスは、ロールと、そのロールに関連付けられたデータを保持します。詳細...
| ヘッダー: | #include <QModelRoleData> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
| 以下のように: | Qt 6.0 |
パブリック関数
| QModelRoleData(int role) | |
| void | clearData() |
| QVariant & | data() |
| const QVariant & | data() const |
| int | role() const |
| void | setData(T &&value) |
詳細な説明
QModelRoleData オブジェクトは、アイテムのロール（Qt::ItemDataRole 列挙型の値、またはカスタムロールの場合は任意の整数）と、そのロールに関連付けられたデータを格納します。
QModelRoleData オブジェクトは通常、ビューやデリゲートによって、データを取得したいロールを指定して作成されます。その後、このオブジェクトはモデルに渡され（QAbstractItemModel::multiData() を参照）、モデルは格納されているロールに対応するデータでオブジェクトを初期化します。最後に、ビューがモデルから取得したデータを可視化します。
「モデル／ビュープログラミング」および「QModelRoleDataSpan 」も参照してください 。
メンバ関数のドキュメント
[explicit noexcept] QModelRoleData::QModelRoleData(int role)
指定されたrole に対して、QModelRoleData オブジェクトを生成します。
Qt::ItemDataRoleも参照してください 。
[noexcept] void QModelRoleData::clearData()
このオブジェクトが保持しているデータを消去します。なお、ロールは変更されず、データのみが消去される点に注意してください。
data()も参照してください 。
[constexpr noexcept] QVariant &QModelRoleData::data()
このオブジェクトが保持するデータを、変更可能な参照として返します。
setData()も参照してください 。
[constexpr noexcept] const QVariant &QModelRoleData::data() const
このオブジェクトが保持するデータを返します。
setData()も参照してください 。
[constexpr noexcept] int QModelRoleData::role() const
このオブジェクトが持つロールを返します。
Qt::ItemDataRoleも参照してください 。
[constexpr noexcept(...)] template <typename T> void QModelRoleData::setData(T &&value)
このオブジェクトが保持するデータを `value` に設定します。`value ` は、QVariant に格納可能なデータ型でなければなりません。
注： noexcept(m_data.setValue(std::forward<T>(value))) がtrue の場合、この関数は noexcept です。
関連項目： data()、clearData()、およびQ_DECLARE_METATYPE 。
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
