QBar3DSeries Class
QBar3DSeries 클래스는 3D 막대 그래프에서 데이터 계열을 나타냅니다. 더 보기...
| Header: | #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 을 참조하세요. |
| 시리즈 이름 | 시리즈의 이름 |
| %<포맷 사양> | 지정된 형식의 항목 값입니다. 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 와 함께 바 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()도 참조하세요 .
© 2025 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.
