QBar3DSeries Class

QBar3DSeries 클래스는 3D 막대 그래프에서 데이터 계열을 나타냅니다. 더 보기...

Header: #include <QBar3DSeries>
CMake: find_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake: QT += graphs
QML에서: Bar3DSeries
상속합니다: QAbstract3DSeries

속성

공공 기능

QBar3DSeries(QObject *parent = nullptr)
QBar3DSeries(QBarDataProxy *dataProxy, QObject *parent = nullptr)
virtual ~QBar3DSeries() override
void clearArray()
void clearRow(qsizetype rowIndex)
QStringList columnLabels() const
QBarDataArray dataArray() &&
const QBarDataArray &dataArray() const &
QBarDataProxy *dataProxy() const
float meshAngle() const
QList<QColor> rowColors() const
QStringList rowLabels() const
QPoint selectedBar() const
void setColumnLabels(const QStringList &labels)
void setDataArray(const QBarDataArray &newDataArray)
void setDataProxy(QBarDataProxy *proxy)
void setMeshAngle(float angle)
void setRowColors(const QList<QColor> &colors)
void setRowLabels(const QStringList &labels)
void setSelectedBar(QPoint position)

신호

void columnLabelsChanged()
void dataArrayChanged(const QBarDataArray &array)
void dataProxyChanged(QBarDataProxy *proxy)
void meshAngleChanged(float angle)
void rowColorsChanged(const QList<QColor> &rowcolors)
void rowLabelsChanged()
void selectedBarChanged(QPoint position)

정적 공용 멤버

상세 설명

이 클래스는 시리즈별 시각적 요소와 시리즈 데이터(데이터 프록시를 통해)를 관리합니다.

프록시-시리즈 관계와 관련하여 몇 가지 핵심 사항을 강조하는 것이 중요합니다. 이 맥락에서 데이터는 시리즈에 저장되며 사용자는 시리즈를 통해 데이터 집합에 액세스할 수 있습니다. 이 시리즈는 프록시 개체에 의해 제어되거나 표현됩니다. 따라서 프록시는 데이터에 대한 다양한 작업을 관리하고 실제 데이터 집합을 업데이트하는 데 사용할 수 있습니다. 그러나 데이터 집합을 편집하려면 이 프록시와 연결된 시리즈를 만들어야 합니다.

시리즈에 대해 데이터 프록시를 명시적으로 설정하지 않으면 시리즈가 기본 프록시를 만듭니다. 다른 프록시를 설정하면 기존 프록시와 시리즈에 추가된 모든 데이터가 삭제됩니다.

QBar3DSeries는 QAbstract3DSeries::setItemLabelFormat()에 대해 다음 형식 태그를 지원합니다:

@rowTitle행 축의 제목
colTitle열 축의 제목
@valueTitle값 축의 제목
rowIdx표시되는 행 인덱스입니다. 그래프 로캘을 사용하여 현지화되었습니다.
colIdx표시되는 열 인덱스. 그래프 로캘을 사용하여 현지화되었습니다.
rowLabel행 축의 레이블
colLabel열 축의 레이블
valueLabel그래프에 연결된 값 축의 형식을 사용하여 서식이 지정된 항목 값입니다. 자세한 내용은 QValue3DAxis::labelFormat 을 참조하세요.
시리즈 이름시리즈의 이름
%<포맷 사양>지정된 형식의 항목 값입니다. QValue3DAxis::labelFormat 와 동일한 규칙을 사용하여 형식화합니다.

예를 들어:

proxy->setItemLabelFormat(QStringLiteral("@valueTitle for (@rowLabel, @colLabel): %.1f"));

Qt Graphs 3D로 데이터 처리Q3DGraphsWidgetItem::locale참조하세요 .

속성 문서

columnLabels : QStringList

이 속성은 배열의 선택적 열 레이블을 보유합니다.

이 배열의 인덱스는 행의 열 인덱스와 일치합니다. 목록이 가장 긴 행보다 짧으면 모든 열에 레이블이 지정되지 않습니다.

함수에 액세스합니다:

QStringList columnLabels() const
void setColumnLabels(const QStringList &labels)

알림 신호:

void columnLabelsChanged()

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참조하세요 .

rowColors : QList<QColor>

이 속성에는 시리즈의 행 색상 목록이 저장됩니다.

이 속성을 사용하여 시리즈의 행을 다른 색상으로 색칠할 수 있습니다. 이 속성을 사용하려면 QGraphsTheme::ColorStyleQGraphsTheme::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)

멤버 함수 문서

[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()도 참조하세요 .

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