Back to Qt.io
Contact Us Blog Download Qt
이 페이지에서

QItemModelBarDataProxy Class

Q3DBars 를 사용하여 항목 모델의 데이터를 표시하기 위한 프록시 클래스. 더 보기...

헤더: #include <QItemModelBarDataProxy>
CMake: find_package(Qt6 REQUIRED COMPONENTS DataVisualization)
target_link_libraries(mytarget PRIVATE Qt6::DataVisualization)
qmake: QT += datavisualization
출시일: QtDataVisualization 1.0
QML에서: ItemModelBarDataProxy
상속: QBarDataProxy
상태: 사용 중단됨

이 클래스는 더 이상 사용되지 않습니다. 새로운 코드에서는 이 클래스를 사용하지 않는 것을 강력히 권장합니다.

공개 타입

enum MultiMatchBehavior { MMBFirst, MMBLast, MMBAverage, MMBCumulative }

속성

공개 함수

QItemModelBarDataProxy(QObject *parent = nullptr)
QItemModelBarDataProxy(QAbstractItemModel *itemModel, QObject *parent = nullptr)
QItemModelBarDataProxy(QAbstractItemModel *itemModel, const QString &valueRole, QObject *parent = nullptr)
QItemModelBarDataProxy(QAbstractItemModel *itemModel, const QString &rowRole, const QString &columnRole, const QString &valueRole, QObject *parent = nullptr)
QItemModelBarDataProxy(QAbstractItemModel *itemModel, const QString &rowRole, const QString &columnRole, const QString &valueRole, const QString &rotationRole, QObject *parent = nullptr)
QItemModelBarDataProxy(QAbstractItemModel *itemModel, const QString &rowRole, const QString &columnRole, const QString &valueRole, const QStringList &rowCategories, const QStringList &columnCategories, QObject *parent = nullptr)
QItemModelBarDataProxy(QAbstractItemModel *itemModel, const QString &rowRole, const QString &columnRole, const QString &valueRole, const QString &rotationRole, const QStringList &rowCategories, const QStringList &columnCategories, QObject *parent = nullptr)
virtual ~QItemModelBarDataProxy()
bool autoColumnCategories() const
bool autoRowCategories() const
QStringList columnCategories() const
int columnCategoryIndex(const QString &category)
QString columnRole() const
QRegularExpression columnRolePattern() const
QString columnRoleReplace() const
QAbstractItemModel *itemModel() const
QItemModelBarDataProxy::MultiMatchBehavior multiMatchBehavior() const
void remap(const QString &rowRole, const QString &columnRole, const QString &valueRole, const QString &rotationRole, const QStringList &rowCategories, const QStringList &columnCategories)
QString rotationRole() const
QRegularExpression rotationRolePattern() const
QString rotationRoleReplace() const
QStringList rowCategories() const
int rowCategoryIndex(const QString &category)
QString rowRole() const
QRegularExpression rowRolePattern() const
QString rowRoleReplace() const
void setAutoColumnCategories(bool enable)
void setAutoRowCategories(bool enable)
void setColumnCategories(const QStringList &categories)
void setColumnRole(const QString &role)
void setColumnRolePattern(const QRegularExpression &pattern)
void setColumnRoleReplace(const QString &replace)
void setItemModel(QAbstractItemModel *itemModel)
void setMultiMatchBehavior(QItemModelBarDataProxy::MultiMatchBehavior behavior)
void setRotationRole(const QString &role)
void setRotationRolePattern(const QRegularExpression &pattern)
void setRotationRoleReplace(const QString &replace)
void setRowCategories(const QStringList &categories)
void setRowRole(const QString &role)
void setRowRolePattern(const QRegularExpression &pattern)
void setRowRoleReplace(const QString &replace)
void setUseModelCategories(bool enable)
void setValueRole(const QString &role)
void setValueRolePattern(const QRegularExpression &pattern)
void setValueRoleReplace(const QString &replace)
bool useModelCategories() const
QString valueRole() const
QRegularExpression valueRolePattern() const
QString valueRoleReplace() const

신호

void autoColumnCategoriesChanged(bool enable)
void autoRowCategoriesChanged(bool enable)
void columnCategoriesChanged()
void columnRoleChanged(const QString &role)
void columnRolePatternChanged(const QRegularExpression &pattern)
void columnRoleReplaceChanged(const QString &replace)
void itemModelChanged(const QAbstractItemModel *itemModel)
void multiMatchBehaviorChanged(QItemModelBarDataProxy::MultiMatchBehavior behavior)
void rotationRoleChanged(const QString &role)
void rotationRolePatternChanged(const QRegularExpression &pattern)
void rotationRoleReplaceChanged(const QString &replace)
void rowCategoriesChanged()
void rowRoleChanged(const QString &role)
void rowRolePatternChanged(const QRegularExpression &pattern)
void rowRoleReplaceChanged(const QString &replace)
void useModelCategoriesChanged(bool enable)
void valueRoleChanged(const QString &role)
void valueRolePatternChanged(const QRegularExpression &pattern)
void valueRoleReplaceChanged(const QString &replace)

상세 설명

QItemModelBarDataProxy를 사용하면 QAbstractItemModel 에서 파생된 모델을 Q3DBars 의 데이터 소스로 활용할 수 있습니다. 이 클래스는 정의된 매핑을 사용하여 모델의 데이터를 Q3DBars 그래프의 행, 열 및 값에 매핑합니다.

매핑이나 모델이 변경될 때마다 데이터가 비동기적으로 해결됩니다. 데이터가 해결되면 QBarDataProxy::arrayReset()이 발송됩니다. 그러나 useModelCategories 속성이 true로 설정된 경우, 동일한 프레임에 전체 모델을 해결하게 하는 변경 사항이 포함되어 있지 않는 한, 단일 항목의 변경 사항은 동기적으로 해결됩니다.

매핑은 다음과 같은 방식으로 사용할 수 있습니다:

  • useModelCategories 속성이 true로 설정된 경우, 이 프록시는 QAbstractItemModel 의 행과 열을 Q3DBars 의 행과 열에 직접 매핑하며, 기본적으로 Qt::DisplayRole 에 대해 반환된 값을 막대 값으로 사용합니다. Qt::DisplayRole 가 적합하지 않은 경우, 사용될 값 역할(value role)을 재정의할 수 있습니다.
  • QAbstractListModel 을 기반으로 한 모델과 같이 데이터가 이미 행과 열로 깔끔하게 정렬되어 있지 않은 모델의 경우, 모델에서 행, 열 및 값 각각에 매핑할 역할을 정의할 수 있습니다.
  • 모델에 포함된 모든 데이터를 포함하지 않으려는 경우, 또는 자동 생성된 행과 열의 순서가 원하는 대로 정렬되지 않은 경우, 행과 열 중 하나 또는 둘 모두에 대해 범주 목록을 명시적으로 정의하여 포함할 행과 열 및 그 순서를 지정할 수 있습니다.

예를 들어, 비즈니스와 관련된 다양한 월별 값을 저장하기 위한 사용자 정의 QAbstractItemModel 이 있다고 가정해 봅시다. 모델의 각 항목에는 “year”, “month”, “income”, “expenses”라는 역할이 있습니다. 데이터를 막대 그래프로 표시하려면 다음과 같이 할 수 있습니다.

// By defining row and column categories, you tell the mapping which row and column each item
// belongs to. The categories must match the data stored in the model in the roles you define
// for row and column mapping. In this example we expect "year" role to return four digit year
// and "month" to return three letter designation for the month.
//
// An example of an item in model would be:
// Requested role -> Returned data
// "year" -> "2006" // Matches the first row category, so this item is added to the first row.
// "month" -> "jan" // Matches the first column category, so this item is added as first item in the row.
// "income" -> "12.1"
// "expenses" -> "9.2"
QStringList years;
QStringList months;
years << "2006" << "2007" << "2008" << "2009" << "2010" << "2011" << "2012";
months << "jan" << "feb" << "mar" << "apr" << "may" << "jun" << "jul" << "aug" << "sep" << "oct" << "nov" << "dec";

QItemModelBarDataProxy *proxy = new QItemModelBarDataProxy(customModel,
                                                           QStringLiteral("year"), // Row role
                                                           QStringLiteral("month"), // Column role
                                                           QStringLiteral("income"), // Value role
                                                           years, // Row categories
                                                           months); // Column categories

//...

// To display different data later, you can simply change the mapping.
proxy->setValueRole(QStringLiteral("expenses"));

모델의 필드에 필요한 정확한 형식의 데이터가 포함되어 있지 않은 경우, 각 역할에 대해 검색 패턴 정규 표현식과 치환 규칙을 지정하여 필요한 형식으로 값을 변환할 수 있습니다. 정규 표현식을 사용한 치환이 어떻게 작동하는지에 대한 자세한 내용은 QString::replace(const QRegularExpression &rx, const QString &after) 함수 설명서를 참조하십시오. 정규 표현식을 사용하면 성능에 영향을 미치므로, 원하는 값을 얻기 위해 검색 및 치환이 필요 없는 항목 모델을 활용하는 것이 더 효율적입니다.

예를 들어, 검색 패턴을 역할과 함께 사용하는 방법에 대해서는 ‘간단한 막대 그래프 예제’를 참조하십시오.

Qt Data Visualization 의 데이터 처리항목도 참조하십시오 .

멤버 유형 문서

enum QItemModelBarDataProxy::MultiMatchBehavior

QItemModelBarDataProxy::multiMatchBehavior 속성의 동작 유형.

상수값설명
QItemModelBarDataProxy::MMBFirst0값은 각 행/열 조합과 일치하는 항목 모델의 첫 번째 항목에서 가져옵니다.
QItemModelBarDataProxy::MMBLast1값은 각 행/열 조합과 일치하는 항목 모델의 마지막 항목에서 가져옵니다.
QItemModelBarDataProxy::MMBAverage2각 행/열 조합과 일치하는 모든 항목의 값을 평균하여, 그 평균값을 막대 값으로 사용합니다.
QItemModelBarDataProxy::MMBCumulative3각 행/열 조합과 일치하는 모든 항목의 값을 더한 합계를 막대값으로 사용합니다.

속성 설명서

autoColumnCategories : bool

이 속성은 열 범주가 자동으로 생성되는지 여부와 관계없이 적용됩니다.

true 로 설정된 경우, 매핑은 명시적으로 설정된 열 범주를 무시하고 모델의 데이터가 해결될 때마다 자동으로 생성된 범주로 덮어씁니다. 기본값은 true 입니다.

액세스 함수:

bool autoColumnCategories() const
void setAutoColumnCategories(bool enable)

알림 신호:

void autoColumnCategoriesChanged(bool enable)

autoRowCategories : bool

이 속성은 행 범주가 자동으로 생성되는지 여부와 관계없이 적용됩니다.

이 속성을 ` true`로 설정하면, 모델의 데이터가 해결될 때마다 매핑은 명시적으로 설정된 행 범주를 무시하고 자동으로 생성된 범주로 덮어씁니다. 기본값은 ` true`입니다.

액세스 함수:

bool autoRowCategories() const
void setAutoRowCategories(bool enable)

알림 신호:

void autoRowCategoriesChanged(bool enable)

columnCategories : QStringList

이 속성은 매핑에 대한 열 범주를 포함합니다.

액세스 함수:

QStringList columnCategories() const
void setColumnCategories(const QStringList &categories)

알림 신호:

void columnCategoriesChanged()

columnRole : QString

이 속성은 매핑에 대한 열 역할을 담당합니다.

액세스 함수:

QString columnRole() const
void setColumnRole(const QString &role)

알림 신호:

void columnRoleChanged(const QString &role)

columnRolePattern : QRegularExpression

이 속성은 열 역할에 의해 매핑된 값이 열 범주로 사용되기 전에 검색 및 치환이 수행되는지 여부를 나타냅니다.

이 속성은 매핑된 값 중에서 교체할 부분을 찾기 위한 정규식을 지정하며, ` columnRoleReplace ` 속성에는 교체할 문자열이 포함됩니다. 이는 예를 들어, 항목 모델의 단일 타임스탬프 필드에서 행 및 열 범주를 파싱할 때 유용합니다.

액세스 함수:

QRegularExpression columnRolePattern() const
void setColumnRolePattern(const QRegularExpression &pattern)

알림 신호:

void columnRolePatternChanged(const QRegularExpression &pattern)

columnRole 및 columnRoleReplace도 참조하십시오 .

columnRoleReplace : QString

이 속성은 ` columnRolePattern`와 함께 사용될 대체 내용을 저장합니다.

기본값은 빈 문자열입니다. 정규식을 사용한 검색 및 치환이 어떻게 작동하는지에 대한 자세한 내용은 QString::replace(const QRegularExpression &rx, const QString &after) 함수 문서를 참조하십시오.

액세스 함수:

QString columnRoleReplace() const
void setColumnRoleReplace(const QString &replace)

알림 신호:

void columnRoleReplaceChanged(const QString &replace)

columnRole 및 columnRolePattern도 참조하십시오 .

itemModel : QAbstractItemModel*

이 속성은 항목 모델을 포함합니다.

액세스 함수:

QAbstractItemModel *itemModel() const
void setItemModel(QAbstractItemModel *itemModel)

알림 신호:

void itemModelChanged(const QAbstractItemModel *itemModel)

multiMatchBehavior : MultiMatchBehavior

각 행/열 조합에 대해 여러 개의 일치 항목이 있는 경우 이를 어떻게 처리할지 지정합니다.

기본값은 ` QItemModelBarDataProxy::MMBLast`입니다. 선택한 동작은 막대의 값과 회전 모두에 영향을 미칩니다.

예를 들어, 불규칙한 간격으로 수집된 타임스탬프 데이터가 포함된 항목 모델이 있고, 각 날짜별 데이터 항목의 총값을 막대 그래프로 시각화하고 싶을 수 있습니다. 이 경우 각 막대가 하루를 나타내도록 행 및 열 범주를 지정하고, multiMatchBehavior를 QItemModelBarDataProxy::MMBCumulative 로 설정하면 됩니다.

액세스 함수:

QItemModelBarDataProxy::MultiMatchBehavior multiMatchBehavior() const
void setMultiMatchBehavior(QItemModelBarDataProxy::MultiMatchBehavior behavior)

Notifier 신호:

void multiMatchBehaviorChanged(QItemModelBarDataProxy::MultiMatchBehavior behavior)

rotationRole : QString

이 속성은 매핑에 대한 회전 역할을 담당합니다.

액세스 함수:

QString rotationRole() const
void setRotationRole(const QString &role)

알림 신호:

void rotationRoleChanged(const QString &role)

rotationRolePattern : QRegularExpression

이 속성은 회전 역할에 의해 매핑된 값이 막대 회전 각도로 사용되기 전에 검색 및 치환 작업이 수행되는지 여부를 나타냅니다.

이 속성은 매핑된 값 중에서 대체할 부분을 찾기 위한 정규식을 지정하며, ` rotationRoleReplace ` 속성에는 대체할 문자열이 포함됩니다.

액세스 함수:

QRegularExpression rotationRolePattern() const
void setRotationRolePattern(const QRegularExpression &pattern)

알림 신호:

void rotationRolePatternChanged(const QRegularExpression &pattern)

rotationRole 및 rotationRoleReplace도 참조하십시오 .

rotationRoleReplace : QString

이 속성은 rotationRolePattern 와 함께 사용될 대체 내용을 포함합니다.

기본값은 빈 문자열입니다. 정규식을 사용한 검색 및 대체 기능의 작동 방식에 대한 자세한 내용은 QString::replace(const QRegularExpression &rx, const QString &after) 함수 설명서를 참조하십시오.

액세스 함수:

QString rotationRoleReplace() const
void setRotationRoleReplace(const QString &replace)

알림 신호:

void rotationRoleReplaceChanged(const QString &replace)

rotationRole 및 rotationRolePattern도 참조하십시오 .

rowCategories : QStringList

이 속성은 매핑에 대한 행 범주를 포함합니다.

액세스 함수:

QStringList rowCategories() const
void setRowCategories(const QStringList &categories)

알림 신호:

void rowCategoriesChanged()

rowRole : QString

이 속성은 매핑에 대한 행 역할을 담당합니다.

액세스 함수:

QString rowRole() const
void setRowRole(const QString &role)

알림 신호:

void rowRoleChanged(const QString &role)

rowRolePattern : QRegularExpression

이 속성은 행 역할에 의해 매핑된 값이 행 범주로 사용되기 전에 검색 및 바꾸기 작업이 수행되는지 여부를 나타냅니다.

이 속성은 매핑된 값 중에서 대체할 부분을 찾기 위한 정규식을 지정하며, ` rowRoleReplace ` 속성에는 대체할 문자열이 포함됩니다. 이는 예를 들어, 항목 모델의 단일 타임스탬프 필드에서 행 및 열 범주를 파싱할 때 유용합니다.

액세스 함수:

QRegularExpression rowRolePattern() const
void setRowRolePattern(const QRegularExpression &pattern)

알림 신호:

void rowRolePatternChanged(const QRegularExpression &pattern)

rowRole 및 rowRoleReplace도 참조하십시오 .

rowRoleReplace : QString

이 속성은 ` rowRolePattern`와 함께 사용될 대체 내용을 저장합니다.

기본값은 빈 문자열입니다. 정규식을 사용한 검색 및 치환이 어떻게 작동하는지에 대한 자세한 내용은 QString::replace(const QRegularExpression &rx, const QString &after) 함수 문서를 참조하십시오.

액세스 함수:

QString rowRoleReplace() const
void setRowRoleReplace(const QString &replace)

알림 신호:

void rowRoleReplaceChanged(const QString &replace)

rowRole 및 rowRolePattern도 참조하십시오 .

useModelCategories : bool

이 속성은 매핑에 행 및 열 역할과 범주가 사용되는지 여부와 관계없이 적용됩니다.

true 로 설정된 경우, 매핑은 행 및 열 역할과 범주를 무시하고 대신 모델의 행과 열을 사용합니다. 기본값은 false 입니다.

액세스 함수:

bool useModelCategories() const
void setUseModelCategories(bool enable)

알림 신호:

void useModelCategoriesChanged(bool enable)

valueRole : QString

이 속성은 매핑에 대한 ‘역할’ 값을 나타냅니다.

액세스 함수:

QString valueRole() const
void setValueRole(const QString &role)

알림 신호:

void valueRoleChanged(const QString &role)

valueRolePattern : QRegularExpression

이 속성은 값 역할에 의해 매핑된 값이 막대 값으로 사용되기 전에 해당 값에 대해 검색 및 치환 작업이 수행되는지 여부를 나타냅니다.

이 속성은 매핑된 값 중에서 대체할 부분을 찾기 위한 정규식을 지정하며, ` valueRoleReplace ` 속성에는 대체할 문자열이 포함됩니다.

액세스 함수:

QRegularExpression valueRolePattern() const
void setValueRolePattern(const QRegularExpression &pattern)

알림 신호:

void valueRolePatternChanged(const QRegularExpression &pattern)

valueRole 및 valueRoleReplace도 참조하십시오 .

valueRoleReplace : QString

이 속성은 ` valueRolePattern`와 함께 사용될 대체 내용을 저장합니다.

기본값은 빈 문자열입니다. 정규식을 사용한 검색 및 치환이 어떻게 작동하는지에 대한 자세한 내용은 QString::replace(const QRegularExpression &rx, const QString &after) 함수 문서를 참조하십시오.

액세스 함수:

QString valueRoleReplace() const
void setValueRoleReplace(const QString &replace)

알림 신호:

void valueRoleReplaceChanged(const QString &replace)

valueRole 및 valueRolePattern도 참조하십시오 .

멤버 함수 문서

[explicit] QItemModelBarDataProxy::QItemModelBarDataProxy(QObject *parent = nullptr)

선택 사항인 ` parent`을 사용하여 `QItemModelBarDataProxy`를 생성합니다.

[explicit] QItemModelBarDataProxy::QItemModelBarDataProxy(QAbstractItemModel *itemModel, QObject *parent = nullptr)

itemModel 와 선택 사항인 parent 을 사용하여 QItemModelBarDataProxy를 생성합니다. 일반적으로 항목 모델은 다른 컨트롤이 소유하므로, 프록시는 itemModel 의 소유권을 가져가지 않습니다.

[explicit] QItemModelBarDataProxy::QItemModelBarDataProxy(QAbstractItemModel *itemModel, const QString &valueRole, QObject *parent = nullptr)

itemModel 와 선택 사항인 parent 를 사용하여 QItemModelBarDataProxy를 생성합니다. 일반적으로 항목 모델은 다른 컨트롤이 소유하므로, 프록시는 itemModel 에 대한 소유권을 가지지 않습니다. 값 역할은 valueRole 로 설정됩니다. 이 생성자는 데이터가 이미 행과 열로 올바르게 정렬된 모델과 함께 사용하도록 설계되었으므로, useModelCategories 속성도 true로 설정합니다.

[explicit] QItemModelBarDataProxy::QItemModelBarDataProxy(QAbstractItemModel *itemModel, const QString &rowRole, const QString &columnRole, const QString &valueRole, QObject *parent = nullptr)

itemModel 와 선택 사항인 parent 를 사용하여 QItemModelBarDataProxy를 생성합니다. 일반적으로 항목 모델은 다른 컨트롤이 소유하므로, 프록시는 itemModel 의 소유권을 가져가지 않습니다. 역할 매핑은 rowRole, columnRole 및 valueRole 를 사용하여 설정됩니다.

[explicit] QItemModelBarDataProxy::QItemModelBarDataProxy(QAbstractItemModel *itemModel, const QString &rowRole, const QString &columnRole, const QString &valueRole, const QString &rotationRole, QObject *parent = nullptr)

itemModel 와 선택 사항인 parent 를 사용하여 QItemModelBarDataProxy를 생성합니다. 일반적으로 항목 모델은 다른 컨트롤이 소유하므로, 프록시는 itemModel 에 대한 소유권을 가져가지 않습니다. 역할 매핑은 rowRole, columnRole, valueRole 및 rotationRole 를 사용하여 설정됩니다.

[explicit] QItemModelBarDataProxy::QItemModelBarDataProxy(QAbstractItemModel *itemModel, const QString &rowRole, const QString &columnRole, const QString &valueRole, const QStringList &rowCategories, const QStringList &columnCategories, QObject *parent = nullptr)

itemModel 와 선택 사항인 parent 를 사용하여 QItemModelBarDataProxy를 생성합니다. 일반적으로 항목 모델은 다른 컨트롤이 소유하므로, 프록시는 itemModel 의 소유권을 인수하지 않습니다. 역할 매핑은 rowRole, columnRole 및 valueRole 로 설정됩니다. 행 및 열 범주는 rowCategories 와 columnCategories 로 설정됩니다. 또한 이 생성자는 autoRowCategories 와 autoColumnCategories 를 false로 설정합니다.

[explicit] QItemModelBarDataProxy::QItemModelBarDataProxy(QAbstractItemModel *itemModel, const QString &rowRole, const QString &columnRole, const QString &valueRole, const QString &rotationRole, const QStringList &rowCategories, const QStringList &columnCategories, QObject *parent = nullptr)

itemModel 와 선택 사항인 parent 를 사용하여 QItemModelBarDataProxy를 생성합니다. 일반적으로 항목 모델은 다른 컨트롤이 소유하므로, 프록시는 itemModel 의 소유권을 가져가지 않습니다. 역할 매핑은 rowRole, columnRole, valueRole 및 rotationRole 로 설정됩니다. 행 및 열 범주는 rowCategories 와 columnCategories 로 설정됩니다. 또한 이 생성자는 autoRowCategories 와 autoColumnCategories 를 false로 설정합니다.

[virtual noexcept] QItemModelBarDataProxy::~QItemModelBarDataProxy()

QItemModelBarDataProxy 를 삭제합니다.

[invokable] int QItemModelBarDataProxy::columnCategoryIndex(const QString &category)

지정된 ‘ category ’의 열 범주 목록 내 인덱스를 반환합니다. 해당 범주가 발견되지 않으면 -1이 반환됩니다.

참고: 열 범주 자동 생성 기능이 사용 중인경우 , 모델의 데이터가 처음 해결되기 전까지는 이 메서드가 유효한 인덱스를 반환하지 않습니다.

참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하십시오.

void QItemModelBarDataProxy::remap(const QString &rowRole, const QString &columnRole, const QString &valueRole, const QString &rotationRole, const QStringList &rowCategories, const QStringList &columnCategories)

매핑에서 rowRole, columnRole, valueRole, rotationRole, rowCategories 및 columnCategories 를 변경합니다.

[invokable] int QItemModelBarDataProxy::rowCategoryIndex(const QString &category)

지정된 행 범주( category )가 행 범주 목록에서 차지하는 인덱스를 반환합니다. 행 범주 목록이 비어 있는 경우 -1이 반환됩니다.

참고: 자동 행 범주 생성이 사용 중인경우 , 모델의 데이터가 처음 해결되기 전까지는 이 메서드가 유효한 인덱스를 반환하지 않습니다.

참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 를 참조하십시오.

void QItemModelBarDataProxy::setItemModel(QAbstractItemModel *itemModel)

항목 모델을 ` itemModel`로 설정합니다. 모델에 대한 소유권을 가져오지는 않지만, 모델에 연결하여 변경 사항을 수신 대기합니다.

참고: itemModel 속성에 대한세터 함수입니다.

itemModel()도 참조하십시오 .

© 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.