이 페이지에서

QHPieModelMapper Class

QHPieModelMapper는 파이 시리즈를 위한 수평형 모델 매퍼입니다. 더 보기...

Header: #include <QHPieModelMapper>
In QML: HPieModelMapper
Inherits: QPieModelMapper
Status: Deprecated

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

속성

공개 함수

QHPieModelMapper(QObject *parent = nullptr)
int columnCount() const
int firstColumn() const
int labelsRow() const
QAbstractItemModel *model() const
QPieSeries *series() const
void setColumnCount(int columnCount)
void setFirstColumn(int firstColumn)
void setLabelsRow(int labelsRow)
void setModel(QAbstractItemModel *model)
void setSeries(QPieSeries *series)
void setValuesRow(int valuesRow)
int valuesRow() const

신호

상세 설명

모델 매퍼를 사용하면 ` QAbstractItemModel ` 클래스에서 파생된 데이터 모델을 차트의 데이터 소스로 활용할 수 있습니다. 수평 모델 매퍼는 데이터 모델과 ` QPieSeries` 간의 연결을 생성하는 데 사용되며, 이를 통해 데이터 모델의 각 열은 파이 차트의 한 조각을 정의하고, 각 행은 해당 파이 조각의 레이블이나 값에 매핑됩니다.

데이터를 조작하는 데 모델 및 파이 시리즈 속성을 모두 사용할 수 있습니다. 모델 매퍼는 파이 시리즈와 데이터 모델을 동기화된 상태로 유지합니다.

속성 설명서

columnCount : int

이 속성은 파이 시리즈의 데이터로 매핑되는 모델의 열 수를 저장합니다.

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

액세스 함수:

int columnCount() const
void setColumnCount(int columnCount)

알림 신호:

firstColumn : int

이 속성은 첫 번째 슬라이스 값이 포함된 모델의 열을 나타냅니다.

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

액세스 함수:

int firstColumn() const
void setFirstColumn(int firstColumn)

알림 신호:

labelsRow : int

이 속성은 파이 차트의 각 조각 레이블과 동기화되어 유지되는 모델의 행을 나타냅니다.

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

액세스 함수:

int labelsRow() const
void setLabelsRow(int labelsRow)

알림 신호:

model : QAbstractItemModel*

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

액세스 함수:

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

알림 신호:

void modelReplaced()

series : QPieSeries*

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

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

액세스 함수:

QPieSeries *series() const
void setSeries(QPieSeries *series)

알림 신호:

valuesRow : int

이 속성은 파이 차트의 각 조각 값과 동기화되어 유지되는 모델의 행을 나타냅니다.

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

액세스 함수:

int valuesRow() const
void setValuesRow(int valuesRow)

알림 신호:

멤버 함수 문서

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

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

[signal] void QHPieModelMapper::columnCountChanged()

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

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

[signal] void QHPieModelMapper::firstColumnChanged()

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

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

int QHPieModelMapper::labelsRow() const

파이 차트의 각 조각 레이블과 동기화되어 있는 모델의 행을 반환합니다.

참고: labelsRow 속성에 대한게터 함수입니다.

참조: setLabelsRow().

[signal] void QHPieModelMapper::labelsRowChanged()

이 신호는 레이블 행이 변경될 때 발생합니다.

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

[signal] void QHPieModelMapper::modelReplaced()

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

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

[signal] void QHPieModelMapper::seriesReplaced()

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

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

void QHPieModelMapper::setLabelsRow(int labelsRow)

파이 차트의 각 조각 레이블과 동기화되는 모델 행을 ` labelsRow`로 설정합니다.

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

labelsRow()도 참조하십시오 .

void QHPieModelMapper::setValuesRow(int valuesRow)

파이 차트의 각 조각 값과 동기화되는 모델 행을 ` valuesRow`로 설정합니다.

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

valuesRow()도 참조하십시오 .

int QHPieModelMapper::valuesRow() const

파이 차트의 각 조각 값과 동기화되어 있는 모델의 행을 반환합니다.

참고: valuesRow 속성에 대한게터 함수입니다.

참조: ` setValuesRow()` 함수.

[signal] void QHPieModelMapper::valuesRowChanged()

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

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

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