QBar3DSeries Class
QBar3DSeries 클래스는 3D 막대 그래프의 데이터 시계를 나타냅니다. 더 보기...
| 헤더: | #include <QBar3DSeries> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS DataVisualization) target_link_libraries(mytarget PRIVATE Qt6::DataVisualization) |
| qmake: | QT += datavisualization |
| 출시일: | QtDataVisualization 1.0 |
| QML에서: | Bar3DSeries |
| 상속: | QAbstract3DSeries |
| 상태: | 사용 중단됨 |
이 클래스는 더 이상 사용되지 않습니다. 새로운 코드에서는 이 클래스를 사용하지 않는 것을 강력히 권장합니다.
속성
- dataProxy : QBarDataProxy*
- meshAngle : float
(since 6.3)rowColors : QList<QColor>- selectedBar : QPoint
공개 함수
| QBar3DSeries(QObject *parent = nullptr) | |
| QBar3DSeries(QBarDataProxy *dataProxy, QObject *parent = nullptr) | |
| virtual | ~QBar3DSeries() |
| QBarDataProxy * | dataProxy() const |
| float | meshAngle() const |
| QList<QColor> | rowColors() const |
| QPoint | selectedBar() const |
| void | setDataProxy(QBarDataProxy *proxy) |
| void | setMeshAngle(float angle) |
| void | setRowColors(const QList<QColor> &colors) |
| void | setSelectedBar(const QPoint &position) |
신호
| void | dataProxyChanged(QBarDataProxy *proxy) |
| void | meshAngleChanged(float angle) |
| void | rowColorsChanged(const QList<QColor> &rowcolors) |
| void | selectedBarChanged(const QPoint &position) |
정적 공용 멤버
| 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 Data Visualization 데이터 처리 및 QAbstract3DGraph::locale도 참조하십시오 .
속성 설명서
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.3] rowColors : QList<QColor>
이 속성은 시리즈의 행 색상 목록을 포함합니다.
이 속성을 사용하면 시리즈의 행을 서로 다른 색상으로 채울 수 있습니다. 이 속성을 사용하려면 ` Q3DTheme::ColorStyle `을 ` Q3DTheme::ColorStyleUniform `로 설정해야 합니다.
이 열거형은 Qt 6.3에서 도입되었습니다.
액세스 함수:
| QList<QColor> | rowColors() const |
| void | setRowColors(const QList<QColor> &colors) |
알림 신호:
| void | rowColorsChanged(const QList<QColor> &rowcolors) |
Q3DTheme::ColorStyleUniform도 참조하십시오 .
selectedBar : QPoint
이 속성은 선택된 시리즈의 막대를 나타냅니다.
액세스 함수:
| QPoint | selectedBar() const |
| void | setSelectedBar(const QPoint &position) |
알림 신호:
| void | selectedBarChanged(const QPoint &position) |
멤버 함수 문서
[explicit] QBar3DSeries::QBar3DSeries(QObject *parent = nullptr)
parent 를 부모로 하는 'bar 3D' 시리즈를 생성합니다.
[explicit] QBar3DSeries::QBar3DSeries(QBarDataProxy *dataProxy, QObject *parent = nullptr)
데이터 프록시 dataProxy 와 상위 요소 parent 를 사용하여 막대형 3D 시리즈를 생성합니다.
[virtual noexcept] QBar3DSeries::~QBar3DSeries()
3D 막대 차트 시리즈를 삭제합니다.
[static] QPoint QBar3DSeries::invalidSelectionPosition()
선택 항목으로 유효하지 않은 위치를 반환합니다. 이 위치는 selectedBar 속성에 설정되어 해당 시리즈에서 선택 항목을 지웁니다.
QAbstract3DGraph::clearSelection()도 참조하십시오 .
void QBar3DSeries::setSelectedBar(const QPoint &position)
시리즈의 데이터 배열에서 행과 열로 지정된 ‘ position ’ 위치에 있는 막대를 선택합니다.
한 번에 하나의 막대만 선택할 수 있습니다.
이 시리즈에서 선택을 해제하려면 ` invalidSelectionPosition()`를 ` position`로 설정합니다.
이 시리즈가 그래프에 추가되면, 그래프는 사용자 상호 작용에 따라 또는 선택이 무효화될 경우 선택을 조정할 수 있습니다. 추가된 다른 시리즈에서 막대를 선택하면 선택이 해제됩니다.
선택된 막대의 행 앞뒤로 행을 제거하거나 삽입하면, 동일한 막대가 선택된 상태로 유지되도록 선택 범위가 조정됩니다.
참고: 속성 selectedBar 에 대한세터 함수입니다.
selectedBar() 및 QAbstract3DGraph::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.
