이 페이지에서

QVBarModelMapper Class

QVBarModelMapper 클래스는 막대형 시계열을 위한 수직 모델 매퍼입니다. 더 보기...

Header: #include <QVBarModelMapper>
In QML: VBarModelMapper
Inherits: QObject
Status: Deprecated

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

속성

공개 함수

QVBarModelMapper(QObject *parent = nullptr)
int firstBarSetColumn() const
int firstRow() const
int lastBarSetColumn() const
QAbstractItemModel *model() const
int rowCount() const
QAbstractBarSeries *series() const
void setFirstBarSetColumn(int firstBarSetColumn)
void setFirstRow(int firstRow)
void setLastBarSetColumn(int lastBarSetColumn)
void setModel(QAbstractItemModel *model)
void setRowCount(int rowCount)
void setSeries(QAbstractBarSeries *series)

신호

상세 설명

모델 매퍼를 사용하면 ` QAbstractItemModel ` 클래스에서 파생된 데이터 모델을 차트의 데이터 소스로 활용할 수 있습니다. 수직 모델 매퍼는 데이터 모델과 ` QAbstractBarSeries` 간의 연결을 생성하는 데 사용되며, 이를 통해 데이터 모델의 각 열은 막대 세트를 정의하고 각 행은 막대 시리즈의 범주에 매핑됩니다.

데이터를 조작하는 데는 모델 속성과 막대 시리즈 속성을 모두 사용할 수 있습니다. 모델 매퍼는 막대 시리즈와 데이터 모델의 동기화를 유지합니다.

모델 매퍼는 막대 시리즈 내의 모든 막대 세트가 동일한 크기를 갖도록 보장합니다. 따라서 막대 세트에 값을 추가하거나 제거하면 막대 시리즈의 모든 막대 세트에 동일한 변경 사항이 적용됩니다.

자세한 내용은 ‘위젯이 포함된 차트 갤러리’를 참조하십시오.

QHBarModelMapper도 참조하십시오 .

속성 설명서

firstBarSetColumn : int

이 속성은 첫 번째 막대 차트 세트의 데이터 소스로 사용되는 모델의 열을 나타냅니다.

기본값은 -1(유효하지 않은 매핑)입니다.

액세스 함수:

int firstBarSetColumn() const
void setFirstBarSetColumn(int firstBarSetColumn)

알림 신호:

firstRow : int

이 속성은 막대 시리즈에 포함된 막대 집합의 첫 번째 값이 들어 있는 모델의 행을 나타냅니다.

최소값 및 기본값은 0입니다.

액세스 함수:

int firstRow() const
void setFirstRow(int firstRow)

알림 신호:

lastBarSetColumn : int

이 속성은 마지막 막대 세트의 데이터 소스로 사용되는 모델의 열을 나타냅니다.

기본값은 -1(유효하지 않은 매핑)입니다.

액세스 함수:

int lastBarSetColumn() const
void setLastBarSetColumn(int lastBarSetColumn)

알림 신호:

model : QAbstractItemModel*

이 속성은 매퍼에서 사용하는 데이터 모델을 포함합니다.

액세스 함수:

QAbstractItemModel *model() const
void setModel(QAbstractItemModel *model)

알림 신호:

void modelReplaced()

rowCount : int

이 속성은 막대형 시리즈의 데이터로 매핑되는 모델의 행 수를 나타냅니다.

최소값 및 기본값은 -1입니다(값은 모델의 행 수로 제한됨).

액세스 함수:

int rowCount() const
void setRowCount(int rowCount)

알림 신호:

series : QAbstractBarSeries*

이 속성은 매퍼에서 사용하는 막대형 시리즈를 저장합니다.

이 속성이 매퍼에 설정되면 시리즈의 모든 데이터가 삭제됩니다. 새로운 시리즈가 지정되면 기존 시리즈와의 연결이 해제되지만(단, 데이터는 보존됩니다).

액세스 함수:

QAbstractBarSeries *series() const
void setSeries(QAbstractBarSeries *series)

알림 신호:

멤버 함수 설명서

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

parent 의 자식인 매퍼 객체를 생성합니다.

[signal] void QVBarModelMapper::firstBarSetColumnChanged()

이 신호는 첫 번째 막대 세트 열이 변경될 때 발생합니다.

참고: 속성 firstBarSetColumn 에 대한알림 신호입니다.

[signal] void QVBarModelMapper::firstRowChanged()

첫 번째 행이 변경되면 이 신호가 발생합니다.

참고: 속성 ` firstRow`에 대한알림 신호입니다.

[signal] void QVBarModelMapper::lastBarSetColumnChanged()

이 신호는 마지막 막대 세트 열이 변경될 때 발생합니다.

참고: 속성 lastBarSetColumn 에 대한알림 신호입니다.

[signal] void QVBarModelMapper::modelReplaced()

이 신호는 매퍼가 연결된 모델이 변경될 때 발생합니다.

참고: ` model` 속성에 대한알림 신호입니다.

[signal] void QVBarModelMapper::rowCountChanged()

이 신호는 행 수가 변경될 때 발생합니다.

참고: 속성 ` rowCount`에 대한알림 신호입니다.

[signal] void QVBarModelMapper::seriesReplaced()

이 신호는 매퍼가 연결된 막대 시리즈가 변경될 때 발생합니다.

참고: 속성 ` series`에 대한알림 신호입니다.

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