QAreaSeries Class
QAreaSeries 클래스는 데이터를 면적 그래프로 표시합니다. 더 보기...
| Header: | #include <QAreaSeries> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Graphs)target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake: | QT += graphs |
| QML에서: | AreaSeries |
| 상속합니다: | QAbstractSeries |
- 상속된 멤버를 포함한 모든 멤버 목록
- QAreaSeries는 Qt Graphs 2D용 C++ 클래스의 일부입니다.
속성
|
|
공공 기능
| QColor | borderColor() const |
| qreal | borderWidth() const |
| QColor | color() const |
| QQuickShapeGradient * | gradient() const |
| bool | isSelected() const |
| QXYSeries * | lowerSeries() const |
| QColor | selectedBorderColor() const |
| QColor | selectedColor() const |
| QQuickShapeGradient * | selectedGradient() const |
| void | setBorderColor(QColor newBorderColor) |
| void | setBorderWidth(qreal newBorderWidth) |
| void | setColor(QColor newColor) |
| void | setGradient(QQuickShapeGradient *newGradient) |
| void | setLowerSeries(QXYSeries *newLowerSeries) |
| void | setSelected(bool newSelected) |
| void | setSelectedBorderColor(QColor newSelectedBorderColor) |
| void | setSelectedColor(QColor newColor) |
| void | setSelectedGradient(QQuickShapeGradient *newSelectedGradient) |
| void | setUpperSeries(QXYSeries *newUpperSeries) |
| QXYSeries * | upperSeries() const |
신호
| void | borderColorChanged(QColor newBorderColor) |
| void | borderWidthChanged() |
| void | colorChanged(QColor newColor) |
| void | gradientChanged(QQuickShapeGradient *newGradient) |
| void | lowerSeriesChanged() |
| void | selectedBorderColorChanged(QColor newSelectedBorderColor) |
| void | selectedChanged() |
| void | selectedColorChanged(QColor newSelectedColor) |
| void | selectedGradientChanged(QQuickShapeGradient *newGradient) |
| void | upperSeriesChanged() |
상세 설명
면적 그래프는 점으로 구성된 영역을 그리는 데 사용됩니다. 점은 upperSeries 와 lowerSeries 의 두 계열로 정의됩니다. 계열 사이의 영역이 그래프로 그려집니다. upperSeries 만 정의된 경우 영역은 그래프의 아래쪽과 위쪽 계열 사이가 됩니다.
속성 문서
borderColor : QColor
이 속성은 영역의 테두리 색상을 저장합니다. 기본값은 Qt::transparent 이며, 테두리 색상은 테마에 의해 정의됩니다.
기능에 액세스합니다:
| QColor | borderColor() const |
| void | setBorderColor(QColor newBorderColor) |
알림 신호:
| void | borderColorChanged(QColor newBorderColor) |
borderWidth : qreal
이 속성은 영역을 둘러싸는 선의 너비를 보유합니다. 기본값은 -1 이며, 테두리 너비는 테마에 의해 정의됩니다.
함수에 액세스합니다:
| qreal | borderWidth() const |
| void | setBorderWidth(qreal newBorderWidth) |
알림 신호:
| void | borderWidthChanged() |
color : QColor
이 속성은 영역의 채우기 색상을 저장합니다. 기본값은 Qt::transparent 이며, 테마에 의해 색상이 정의됩니다.
참고: gradient 이 null 이 아닌 다른 값으로 설정된 경우 color 보다 우선합니다. 이 경우 color 은 무시됩니다.
액세스 기능:
| QColor | color() const |
| void | setColor(QColor newColor) |
알림 신호:
| void | colorChanged(QColor newColor) |
[since 6.11] gradient : QQuickShapeGradient*
이 속성은 채우기 그라데이션을 정의합니다. 기본적으로 그라데이션은 활성화되지 않으며 값은 null 입니다. 이 경우 채우기는 color 속성을 기반으로 합니다.
참고: 여기서는 그라데이션 유형을 사용할 수 없습니다. 대신 LinearGradient 과 같은 고급 하위 유형 중 하나를 사용하는 것이 좋습니다.
참고: null 가 아닌 다른 것으로 설정하면 gradient 이 color 보다 우선합니다.
이 프로퍼티는 Qt 6.11에 도입되었습니다.
액세스 함수:
| QQuickShapeGradient * | gradient() const |
| void | setGradient(QQuickShapeGradient *newGradient) |
알림 신호:
| void | gradientChanged(QQuickShapeGradient *newGradient) |
lowerSeries : QXYSeries*
영역의 하한을 설정합니다. 이 값이 null이면 그래프 하단이 하한으로 간주됩니다.
함수에 액세스합니다:
| QXYSeries * | lowerSeries() const |
| void | setLowerSeries(QXYSeries *newLowerSeries) |
알림 신호:
| void | lowerSeriesChanged() |
selected : bool
이 영역을 선택한 것으로 설정합니다. 기본값은 false 입니다.
기능에 액세스합니다:
| bool | isSelected() const |
| void | setSelected(bool newSelected) |
알림 신호:
| void | selectedChanged() |
selectedBorderColor : QColor
이 속성은 선택 시 영역의 테두리 색상을 유지합니다. 기본값은 Qt::transparent 이며, 선택한 테두리 색상은 테마에 의해 정의됩니다.
기능에 액세스합니다:
| QColor | selectedBorderColor() const |
| void | setSelectedBorderColor(QColor newSelectedBorderColor) |
알림 신호:
| void | selectedBorderColorChanged(QColor newSelectedBorderColor) |
selectedColor : QColor
이 속성은 선택 시 영역의 채우기 색상을 유지합니다. 기본값은 Qt::transparent 이며, 선택한 색상은 테마에 의해 정의됩니다.
참고: selectedGradient 가 null 이외의 다른 값으로 설정된 경우 selectedColor 보다 우선합니다. 이 경우 selectedColor 은 무시됩니다.
액세스 기능:
| QColor | selectedColor() const |
| void | setSelectedColor(QColor newColor) |
알림 신호:
| void | selectedColorChanged(QColor newSelectedColor) |
[since 6.11] selectedGradient : QQuickShapeGradient*
이 속성은 선택 시 영역의 채우기 그라데이션을 정의합니다. 기본적으로 그라데이션은 활성화되지 않으며 값은 null 입니다. 이 경우 채우기는 selectedColor 속성을 기반으로 합니다.
참고: 여기에서는 그라데이션 유형을 사용할 수 없습니다. 대신 LinearGradient 와 같은 고급 하위 유형 중 하나를 사용하는 것이 좋습니다.
참고: null 가 아닌 다른 것으로 설정하면 selectedGradient 이 selectedColor 보다 우선합니다.
이 프로퍼티는 Qt 6.11에 도입되었습니다.
액세스 함수:
| QQuickShapeGradient * | selectedGradient() const |
| void | setSelectedGradient(QQuickShapeGradient *newSelectedGradient) |
알림 신호:
| void | selectedGradientChanged(QQuickShapeGradient *newGradient) |
upperSeries : QXYSeries*
영역의 위쪽 경계를 설정합니다. 이 값이 null이면 영역이 그려지지 않습니다.
함수에 액세스합니다:
| QXYSeries * | upperSeries() const |
| void | setUpperSeries(QXYSeries *newUpperSeries) |
알림 신호:
| void | upperSeriesChanged() |
© 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.
