QBar3DSeries Class
QBar3DSeries 클래스는 3D 막대 그래프의 데이터 시계를 나타냅니다. 더 보기...
| 헤더: | #include <QBar3DSeries> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Graphs) target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake: | QT += graphs |
| QML에서: | Bar3DSeries |
| 상속: | QAbstract3DSeries |
- 상속된 멤버를 포함한 모든 멤버 목록
- QBar3DSeries는 3D용Qt Graphs C++ 클래스의 일부입니다.
속성
|
|
공개 함수
| QBar3DSeries(QObject *parent = nullptr) | |
| QBar3DSeries(QBarDataProxy *dataProxy, QObject *parent = nullptr) | |
| virtual | ~QBar3DSeries() override |
| void | clearArray() |
| void | clearRow(qsizetype rowIndex) |
| QCategory3DAxis * | columnAxis() const |
| QStringList | columnLabels() const |
| QStringList | customColumnLabels() const |
| QStringList | customRowLabels() const |
| const QBarDataArray & | dataArray() const & |
| QBarDataArray | dataArray() && |
| QBarDataProxy * | dataProxy() const |
| bool | isValueColoringEnabled() const |
| float | meshAngle() const |
| void | resetColumnAxis() |
| void | resetRowAxis() |
| void | resetValueAxis() |
| QCategory3DAxis * | rowAxis() const |
| QList<QColor> | rowColors() const |
| QStringList | rowLabels() const |
| QPoint | selectedBar() const |
| void | setColumnAxis(QCategory3DAxis *axis) |
| void | setColumnLabels(const QStringList &labels) |
| void | setCustomColumnLabels(const QStringList &labels) |
| void | setCustomRowLabels(const QStringList &labels) |
| void | setDataArray(const QBarDataArray &newDataArray) |
| void | setDataProxy(QBarDataProxy *proxy) |
| void | setMeshAngle(float angle) |
| void | setRowAxis(QCategory3DAxis *axis) |
| void | setRowColors(const QList<QColor> &colors) |
| void | setRowLabels(const QStringList &labels) |
| void | setSelectedBar(QPoint position) |
| void | setValueAxis(QValue3DAxis *axis) |
| void | setValueColoringEnabled(bool enabled) |
| QValue3DAxis * | valueAxis() const |
신호
| void | columnAxisChanged(QCategory3DAxis *axis) |
| void | columnLabelsChanged() |
| void | customColumnLabelsChanged(const QStringList &newCustomColumnLabels) |
| void | customRowLabelsChanged(const QStringList &newCustomRowLabels) |
| void | dataArrayChanged(const QBarDataArray &array) |
| void | dataProxyChanged(QBarDataProxy *proxy) |
| void | meshAngleChanged(float angle) |
| void | rowAxisChanged(QCategory3DAxis *axis) |
| void | rowColorsChanged(const QList<QColor> &rowcolors) |
| void | rowLabelsChanged() |
| void | selectedBarChanged(QPoint position) |
| void | valueAxisChanged(QValue3DAxis *axis) |
| void | valueColoringEnabledChanged(bool enabled) |
정적 공용 멤버
| QPoint | invalidSelectionPosition() |
상세 설명
이 클래스는 시리즈 데이터(데이터 프록시를 통해)뿐만 아니라 시리즈 고유의 시각적 요소도 관리합니다.
프록시와 시리즈의 관계와 관련하여 몇 가지 핵심 사항을 강조할 필요가 있습니다. 이 맥락에서 데이터는 시계에 저장되며, 사용자는 시계를 통해 데이터 세트에 액세스할 수 있습니다. 이 시계는 프록시 객체에 의해 제어되거나 표현됩니다. 따라서 프록시를 사용하여 데이터에 대한 다양한 작업을 관리하고 실제 데이터 세트를 업데이트할 수 있습니다. 그러나 데이터 세트를 편집하려면 이 프록시와 연결된 시계를 생성해야 합니다.
시리즈에 데이터 프록시가 명시적으로 설정되어 있지 않은 경우, 시리즈는 기본 프록시를 생성합니다. 다른 프록시를 설정하면 기존 프록시와 시리즈에 추가된 모든 데이터가 삭제됩니다.
QBar3DSeries는 ` QAbstract3DSeries::setItemLabelFormat()`에 대해 다음 형식 태그를 지원합니다:
| @rowTitle | 행 축의 제목 |
| @colTitle | 열 축의 제목 |
| @valueTitle | 값 축의 제목 |
| @rowIdx | 표시되는 행 인덱스. 그래프 로케일을 사용하여 현지화됩니다. |
| @colIdx | 표시되는 열 인덱스. 그래프 로케일을 사용하여 현지화됩니다. |
| @rowLabel | 행 축의 레이블 |
| @colLabel | 열 축의 레이블 |
| @valueLabel | 그래프에 연결된 값 축의 서식을 사용하여 서식화된 항목 값입니다. 자세한 내용은 QValue3DAxis::labelFormat 을 참조하십시오. |
| @seriesName | 시리즈의 이름 |
| %<서식 지정> | 지정된 형식의 항목 값입니다. QValue3DAxis::labelFormat 와 동일한 규칙을 사용하여 서식이 지정됩니다. |
예:
proxy->setItemLabelFormat(QStringLiteral("@valueTitle for (@rowLabel, @colLabel): %.1f"));Qt Graphs , 3D를 사용한 데이터 처리 및 Q3DGraphsWidgetItem::locale도 참조하십시오 .
속성 설명서
[since 6.11] columnAxis : QCategory3DAxis*
해당 시리즈에 대한 추가 열 축을 표시합니다.
참고: 이 추가 축은 그래프의 배치를 조정하지는 않지만, 레이블과 축 격자 세트를 하나 더 추가할 수 있게 해줍니다.
이 열거형은 Qt 6.11에서 도입되었습니다.
액세스 함수:
| QCategory3DAxis * | columnAxis() const |
| void | setColumnAxis(QCategory3DAxis *axis) |
| void | resetColumnAxis() |
Notifier 신호:
| void | columnAxisChanged(QCategory3DAxis *axis) |
columnLabels : QStringList
이 속성은 배열에 대한 선택적 열 레이블을 포함합니다.
이 배열의 인덱스는 행의 열 인덱스와 일치합니다. 목록의 길이가 가장 긴 행보다 짧을 경우, 모든 열에 레이블이 지정되지는 않습니다.
액세스 함수:
| QStringList | columnLabels() const |
| void | setColumnLabels(const QStringList &labels) |
알림 신호:
| void | columnLabelsChanged() |
[since 6.11] customColumnLabels : QStringList
이 속성은 배열에 대한 선택적 사용자 정의 열 레이블을 저장합니다.
이 레이블들은 프록시가 생성한 레이블을 덮어씁니다. 이 배열의 인덱스는 행의 열 인덱스와 일치합니다. 목록의 길이가 가장 긴 행보다 짧을 경우, 모든 열에 레이블이 지정되지는 않습니다.
이 열거형은 Qt 6.11에서 도입되었습니다.
액세스 함수:
| QStringList | customColumnLabels() const |
| void | setCustomColumnLabels(const QStringList &labels) |
Notifier 신호:
| void | customColumnLabelsChanged(const QStringList &newCustomColumnLabels) |
[since 6.11] customRowLabels : QStringList
이 속성은 배열에 대한 선택적 사용자 정의 행 레이블을 저장합니다.
이 레이블들은 프록시가 생성한 레이블을 재정의합니다. 이 배열의 인덱스는 데이터 배열의 행 인덱스와 일치합니다. 목록의 길이가 행 수보다 짧을 경우, 모든 행에 레이블이 적용되지는 않습니다.
이 열거형은 Qt 6.11에서 도입되었습니다.
액세스 함수:
| QStringList | customRowLabels() const |
| void | setCustomRowLabels(const QStringList &labels) |
Notifier 신호:
| void | customRowLabelsChanged(const QStringList &newCustomRowLabels) |
dataArray : QBarDataArray
시리즈에 대한 데이터 배열.
데이터 배열의 참조를 저장합니다.
newDataArray 가 이전 것과 동일하지 않은 경우, 데이터 배열이 설정되면 dataArrayChanged 신호가 발생합니다.
참고: dataArray와 관련된 작업을 수행하기전에 , 해당 프록시에 대한 시리즈를 생성해야 합니다.
액세스 함수:
| const QBarDataArray & | dataArray() const & |
| QBarDataArray | dataArray() && |
| void | setDataArray(const QBarDataArray &newDataArray) |
알림 신호:
| void | dataArrayChanged(const QBarDataArray &array) |
clearRow(qsizetype rowIndex) 및 clearArray()도 참조하십시오 .
dataProxy : QBarDataProxy*
이 속성은 활성 데이터 프록시를 보관합니다.
시리즈는 자신에게 설정된 모든 프록시의 소유권을 가지며, 새로운 프록시가 추가되면 이전에 설정된 프록시는 삭제됩니다. 프록시는 null이거나 다른 시리즈로 설정될 수 없습니다.
액세스 함수:
| QBarDataProxy * | dataProxy() const |
| void | setDataProxy(QBarDataProxy *proxy) |
알림 신호:
| void | dataProxyChanged(QBarDataProxy *proxy) |
meshAngle : float
이 속성은 시리즈 회전 각도를 도 단위로 저장합니다.
이 속성을 설정하는 것은 다음 호출과 동일합니다:
setMeshRotation(QQuaternion::fromAxisAndAngle(0.0f, 1.0f, 0.0f, angle))참고: 이 속성을 읽을때는 ` QAbstract3DSeries::meshRotation ` 값을 기반으로 부동 소수점 정밀도를 사용하여 계산되며, 항상 0도에서 360도 사이의 값을 반환합니다.
액세스 함수:
| float | meshAngle() const |
| void | setMeshAngle(float angle) |
알림 신호:
| void | meshAngleChanged(float angle) |
QAbstract3DSeries::meshRotation도 참조하십시오 .
[since 6.11] rowAxis : QCategory3DAxis*
해당 시리즈에 대한 추가 행 축을 표시합니다.
참고: 추가축은 그래프의 적합도를 조정하지는 않지만, 레이블 세트와 축 격자 한 세트를 더 추가할 수 있게 해줍니다.
이 열거형은 Qt 6.11에서 도입되었습니다.
액세스 함수:
| QCategory3DAxis * | rowAxis() const |
| void | setRowAxis(QCategory3DAxis *axis) |
| void | resetRowAxis() |
Notifier 신호:
| void | rowAxisChanged(QCategory3DAxis *axis) |
rowColors : QList<QColor>
이 속성은 시리즈의 행 색상 목록을 포함합니다.
이 속성을 사용하면 시리즈의 행을 서로 다른 색상으로 채울 수 있습니다. 이 속성을 사용하려면 ' QGraphsTheme::ColorStyle '을 ' QGraphsTheme::ColorStyle::Uniform '로 설정해야 합니다.
액세스 함수:
| QList<QColor> | rowColors() const |
| void | setRowColors(const QList<QColor> &colors) |
알림 신호:
| void | rowColorsChanged(const QList<QColor> &rowcolors) |
QGraphsTheme::ColorStyle::Uniform도 참조하십시오 .
rowLabels : QStringList
이 속성은 배열에 대한 선택적 행 레이블을 포함합니다.
이 배열의 인덱스는 데이터 배열의 행 인덱스와 일치합니다. 목록의 길이가 행 수보다 짧을 경우, 모든 행에 레이블이 지정되지는 않습니다.
액세스 함수:
| QStringList | rowLabels() const |
| void | setRowLabels(const QStringList &labels) |
알림 신호:
| void | rowLabelsChanged() |
selectedBar : QPoint
이 속성은 선택된 시리즈의 막대를 나타냅니다.
액세스 함수:
| QPoint | selectedBar() const |
| void | setSelectedBar(QPoint position) |
알림 신호:
| void | selectedBarChanged(QPoint position) |
[since 6.11] valueAxis : QValue3DAxis*
시리즈에 대한 추가 값 축을 지정합니다. 축이 지정된 경우, 시리즈는 해당 축의 최소값과 최대값에 맞춰 조정됩니다.
이 열거형은 Qt 6.11에서 도입되었습니다.
액세스 함수:
| QValue3DAxis * | valueAxis() const |
| void | setValueAxis(QValue3DAxis *axis) |
| void | resetValueAxis() |
Notifier 신호:
| void | valueAxisChanged(QValue3DAxis *axis) |
[since 6.9] valueColoringEnabled : bool
주어진 값을 사용하여 범위 그라데이션에 따라 막대 전체에 색상을 적용합니다.
이 속성을 사용하면 각 막대의 값과 지정된 범위 그라데이션에 따라 각 막대를 개별적으로 채색할 수 있습니다. 이 속성을 사용하려면 ` QGraphsTheme::ColorStyle `을 ` QGraphsTheme::ColorStyle::RangeGradient `로 설정해야 합니다.
이 열거형은 Qt 6.9에서 도입되었습니다.
액세스 함수:
| bool | isValueColoringEnabled() const |
| void | setValueColoringEnabled(bool enabled) |
알림 신호:
| void | valueColoringEnabledChanged(bool enabled) |
QGraphsTheme::ColorStyle::RangeGradient도 참조하십시오 .
멤버 함수 문서
[explicit] QBar3DSeries::QBar3DSeries(QObject *parent = nullptr)
parent 를 부모로 하는 막대형 3D 시리즈를 생성합니다.
[explicit] QBar3DSeries::QBar3DSeries(QBarDataProxy *dataProxy, QObject *parent = nullptr)
데이터 프록시 dataProxy 및 상위 항목 parent 을 사용하여 막대형 3D 시리즈를 생성합니다.
[override virtual noexcept] QBar3DSeries::~QBar3DSeries()
3D 막대 차트 시리즈를 삭제합니다.
void QBar3DSeries::clearArray()
기존 배열을 지웁니다.
void QBar3DSeries::clearRow(qsizetype rowIndex)
지정된 ` rowIndex`에 따라 배열의 기존 행을 지웁니다.
[static] QPoint QBar3DSeries::invalidSelectionPosition()
선택 항목으로 유효하지 않은 위치를 반환합니다. 이 위치는 selectedBar 속성에 설정되어 해당 시리즈에서 선택 항목을 지웁니다.
Q3DGraphsWidgetItem::clearSelection()도 참조하십시오 .
void QBar3DSeries::setSelectedBar(QPoint position)
시리즈의 데이터 배열에서 행과 열로 지정된 position 위치에 있는 막대를 선택합니다.
한 번에 하나의 막대만 선택할 수 있습니다.
이 시리즈에서 선택을 해제하려면 invalidSelectionPosition()을 position 로 설정합니다.
이 시리즈가 그래프에 추가된 경우, 그래프는 사용자 상호 작용에 따라 또는 선택이 무효화될 때 선택을 조정할 수 있습니다. 추가된 다른 시리즈에서 막대를 선택하면 선택이 해제됩니다.
선택된 막대의 행 앞뒤로 행을 제거하거나 삽입하면, 동일한 막대가 선택된 상태로 유지되도록 선택 사항이 조정됩니다.
참고: 속성 selectedBar 에 대한세터 함수입니다.
selectedBar() 및 Q3DGraphsWidgetItem::clearSelection()도 참조하십시오 .
© 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.
