QCandlestickSeries Class
QCandlestickSeries 클래스는 데이터를 캔들차트 형태로 표시합니다. 더 보기...
| Header: | #include <QCandlestickSeries> |
| In QML: | CandlestickSeries |
| Inherits: | QAbstractSeries |
| Status: | Deprecated |
이 클래스는 더 이상 권장되지 않습니다. 새로운 코드에서는 이 클래스를 사용하지 않는 것을 강력히 권장합니다.
속성
|
|
공개 함수
| QCandlestickSeries(QObject *parent = nullptr) | |
| virtual | ~QCandlestickSeries() |
| bool | append(QCandlestickSet *set) |
| bool | append(const QList<QCandlestickSet *> &sets) |
| bool | bodyOutlineVisible() const |
| qreal | bodyWidth() const |
| QBrush | brush() const |
| bool | capsVisible() const |
| qreal | capsWidth() const |
| void | clear() |
| int | count() const |
| QColor | decreasingColor() const |
| QColor | increasingColor() const |
| bool | insert(int index, QCandlestickSet *set) |
| qreal | maximumColumnWidth() const |
| qreal | minimumColumnWidth() const |
| QPen | pen() const |
| bool | remove(QCandlestickSet *set) |
| bool | remove(const QList<QCandlestickSet *> &sets) |
| void | setBodyOutlineVisible(bool bodyOutlineVisible) |
| void | setBodyWidth(qreal bodyWidth) |
| void | setBrush(const QBrush &brush) |
| void | setCapsVisible(bool capsVisible) |
| void | setCapsWidth(qreal capsWidth) |
| void | setDecreasingColor(const QColor &decreasingColor) |
| void | setIncreasingColor(const QColor &increasingColor) |
| void | setMaximumColumnWidth(qreal maximumColumnWidth) |
| void | setMinimumColumnWidth(qreal minimumColumnWidth) |
| void | setPen(const QPen &pen) |
| QList<QCandlestickSet *> | sets() const |
| bool | take(QCandlestickSet *set) |
재구현된 공용 함수
| virtual QAbstractSeries::SeriesType | type() const override |
신호
| void | bodyOutlineVisibilityChanged() |
| void | bodyWidthChanged() |
| void | brushChanged() |
| void | candlestickSetsAdded(const QList<QCandlestickSet *> &sets) |
| void | candlestickSetsRemoved(const QList<QCandlestickSet *> &sets) |
| void | capsVisibilityChanged() |
| void | capsWidthChanged() |
| void | clicked(QCandlestickSet *set) |
| void | countChanged() |
| void | decreasingColorChanged() |
| void | doubleClicked(QCandlestickSet *set) |
| void | hovered(bool status, QCandlestickSet *set) |
| void | increasingColorChanged() |
| void | maximumColumnWidthChanged() |
| void | minimumColumnWidthChanged() |
| void | penChanged() |
| void | pressed(QCandlestickSet *set) |
| void | released(QCandlestickSet *set) |
상세 설명
이 클래스는 개별 캔들스틱 항목을 담는 컨테이너 역할을 합니다. ` QBarCategoryAxis`을 사용할 때 각 항목은 자체 범주에 그려집니다. ` QBarCategoryAxis` 대신 ` QDateTimeAxis ` 및 ` QValueAxis `을 사용할 수 있습니다. 이 경우 각 캔들스틱 항목은 타임스탬프 값에 따라 그려집니다.
참고: 타임스탬프는 QCandlestickSeries 내에서 고유해야 합니다. QBarCategoryAxis 를 사용할 경우, 동일한 타임스탬프를 공유하는 캔들스틱 항목 중 첫 번째 항목만 그려집니다. 차트에 여러 개의 QCandlestickSeries 인스턴스가 포함된 경우, 서로 다른 시리즈에 속하지만 동일한 타임스탬프를 공유하는 항목들은 동일한 범주에 그려집니다. QValueAxis 또는 QDateTimeAxis 를 사용할 경우, 동일한 타임스탬프를 공유하는 캔들스틱 항목들은 서로 겹치게 됩니다.
캔들스틱 차트를 만드는 방법은 ‘위젯이 포함된 차트 갤러리(Charts with Widgets Gallery )’를 참조하십시오.

QCandlestickSet, QBarCategoryAxis, QDateTimeAxis 및 QValueAxis도 참조하십시오 .
속성 문서
bodyOutlineVisible : bool
이 속성은 캔들스틱 본문의 윤곽선 표시 여부를 결정합니다.
액세스 함수:
| bool | bodyOutlineVisible() const |
| void | setBodyOutlineVisible(bool bodyOutlineVisible) |
알림 신호:
| void | bodyOutlineVisibilityChanged() |
bodyWidth : qreal
이 속성은 캔들스틱 항목이 해당 슬롯 내에서 차지하는 상대적 너비를 0.0에서 1.0 사이의 범위로 지정합니다.
이 범위 밖의 값은 0.0 또는 1.0으로 제한됩니다.
액세스 함수:
| qreal | bodyWidth() const |
| void | setBodyWidth(qreal bodyWidth) |
알림 신호:
| void | bodyWidthChanged() |
brush : QBrush
이 속성은 캔들스틱 항목을 채우는 데 사용되는 브러시를 저장합니다.
액세스 함수:
| QBrush | brush() const |
| void | setBrush(const QBrush &brush) |
알림 신호:
| void | brushChanged() |
capsVisible : bool
이 속성은 캡의 표시 여부를 결정합니다.
액세스 함수:
| bool | capsVisible() const |
| void | setCapsVisible(bool capsVisible) |
알림 신호:
| void | capsVisibilityChanged() |
capsWidth : qreal
이 속성은 캔들스틱 내 상단 및 하단 선의 상대적 너비를 0.0에서 1.0 사이의 범위로 지정합니다.
이 범위 밖의 값은 0.0 또는 1.0으로 제한됩니다.
액세스 함수:
| qreal | capsWidth() const |
| void | setCapsWidth(qreal capsWidth) |
알림 신호:
| void | capsWidthChanged() |
[read-only] count : int
이 속성은 시계열에 포함된 캔들스틱 항목의 개수를 나타냅니다.
액세스 함수:
| int | count() const |
알림 신호:
| void | countChanged() |
decreasingColor : QColor
이 속성은 하락 캔들스틱 항목의 본문 색상을 지정합니다.
캔들스틱은 시가 값이 종가 값보다 높을 때 하락 캔들스틱으로 간주됩니다. 기본적으로 이 속성은 알파 채널이 128로 설정된 브러시 색상으로 지정됩니다. 속성이 유효하지 않은 색상 값으로 설정된 경우에도 기본 색상이 사용됩니다.
액세스 함수:
| QColor | decreasingColor() const |
| void | setDecreasingColor(const QColor &decreasingColor) |
알림 신호:
| void | decreasingColorChanged() |
increasingColor : QColor
이 속성은 상승 캔들스틱 항목의 몸통 색상을 지정합니다.
캔들스틱은 종가가 시가보다 높을 때 상승 캔들스틱으로 간주됩니다. 기본적으로 이 속성은 브러시 색상으로 설정되어 있습니다. 속성이 유효하지 않은 색상 값으로 설정된 경우에도 기본 색상이 사용됩니다.
액세스 함수:
| QColor | increasingColor() const |
| void | setIncreasingColor(const QColor &increasingColor) |
알림 신호:
| void | increasingColorChanged() |
maximumColumnWidth : qreal
이 속성은 캔들스틱 항목의 최대 너비를 픽셀 단위로 지정합니다. 음수 값을 설정하면 최대 너비가 없다는 의미입니다. 모든 음수 값은 -1.0으로 변환됩니다.
액세스 함수:
| qreal | maximumColumnWidth() const |
| void | setMaximumColumnWidth(qreal maximumColumnWidth) |
알림 신호:
| void | maximumColumnWidthChanged() |
minimumColumnWidth : qreal
이 속성은 캔들스틱 항목의 최소 너비를 픽셀 단위로 지정합니다. 음수 값을 설정하면 최소 너비가 없다는 의미입니다. 모든 음수 값은 -1.0으로 변환됩니다.
액세스 함수:
| qreal | minimumColumnWidth() const |
| void | setMinimumColumnWidth(qreal minimumColumnWidth) |
알림 신호:
| void | minimumColumnWidthChanged() |
pen : QPen
이 속성은 캔들스틱 항목의 선을 그리는 데 사용되는 펜을 지정합니다.
액세스 함수:
| QPen | pen() const |
| void | setPen(const QPen &pen) |
알림 신호:
| void | penChanged() |
멤버 함수 설명서
[explicit] QCandlestickSeries::QCandlestickSeries(QObject *parent = nullptr)
빈 QCandlestickSeries 객체를 생성합니다. parent 는 선택 사항입니다.
[virtual noexcept] QCandlestickSeries::~QCandlestickSeries()
시리즈를 삭제합니다. 차트에서 해당 시리즈를 제거합니다.
bool QCandlestickSeries::append(QCandlestickSet *set)
set 로 지정된 단일 캔들스틱 항목을 시계열에 추가하고 해당 항목에 대한 소유권을 인수합니다. 항목이 null이거나 이미 시계열에 존재하는 경우, 해당 항목은 추가되지 않습니다. 추가에 성공하면 true 를 반환하고, 그렇지 않으면 false 를 반환합니다.
bool QCandlestickSeries::append(const QList<QCandlestickSet *> &sets)
sets 로 지정된 캔들스틱 항목 목록을 시퀀스에 추가하고 해당 항목에 대한 소유권을 인수합니다. 항목 중 null이거나, 이미 시퀀스에 속해 있거나, 목록에 두 번 이상 포함된 항목이 있는 경우 아무것도 추가되지 않습니다. 모든 항목이 성공적으로 추가된 경우 true 를 반환하고, 그렇지 않은 경우 false 를 반환합니다.
[signal] void QCandlestickSeries::bodyOutlineVisibilityChanged()
이 신호는 캔들스틱 항목의 본문 윤곽선 가시성이 변경될 때 발생합니다.
참고: 속성 bodyOutlineVisible 에 대한알림 신호입니다.
bodyOutlineVisible도 참조하십시오 .
[signal] void QCandlestickSeries::bodyWidthChanged()
이 신호는 캔들스틱 항목의 너비가 변경될 때 발생합니다.
참고: 속성 bodyWidth 에 대한알림 신호입니다.
bodyWidth도 참조하십시오 .
[signal] void QCandlestickSeries::brushChanged()
이 신호는 캔들스틱 아이템 브러시가 변경될 때 발생합니다.
참고: 속성 brush 에 대한알림 신호입니다.
brush도 참조하십시오 .
[signal] void QCandlestickSeries::candlestickSetsAdded(const QList<QCandlestickSet *> &sets)
sets 로 지정된 캔들스틱 항목이 시계열에 추가되면 이 신호가 발생합니다.
[signal] void QCandlestickSeries::candlestickSetsRemoved(const QList<QCandlestickSet *> &sets)
sets 로 지정된 캔들스틱 항목이 시계열에서 제거될 때 이 신호가 발생합니다.
[signal] void QCandlestickSeries::capsVisibilityChanged()
이 신호는 캔들스틱 항목의 캡 가시성이 변경될 때 발생합니다.
참고: capsVisible 속성에 대한알림 신호입니다.
capsVisible도 참조하십시오 .
[signal] void QCandlestickSeries::capsWidthChanged()
이 신호는 캔들스틱 항목의 상단 너비가 변경될 때 발생합니다.
참고: 속성 capsWidth 에 대한알림 신호입니다.
capsWidth도 참조하십시오 .
void QCandlestickSeries::clear()
시리즈에서 모든 캔들스틱 항목을 제거하고 영구적으로 삭제합니다.
[signal] void QCandlestickSeries::clicked(QCandlestickSet *set)
set 로 지정된 캔들스틱 항목을 차트에서 클릭하면 이 신호가 발생합니다.
int QCandlestickSeries::count() const
시리즈에 포함된 캔들스틱 항목의 개수를 반환합니다.
참고: count 속성에 대한게터 함수입니다.
[signal] void QCandlestickSeries::countChanged()
이 신호는 시계열 내 캔들스틱 항목의 수가 변경될 때 발생합니다.
참고: 속성 count 에 대한알림 신호입니다.
count도 참조하십시오 .
[signal] void QCandlestickSeries::decreasingColorChanged()
이 신호는 캔들스틱 항목의 색상이 어두워질 때 발생합니다.
참고: 속성 decreasingColor 에 대한알림 신호입니다.
decreasingColor도 참조하십시오 .
[signal] void QCandlestickSeries::doubleClicked(QCandlestickSet *set)
set 로 지정된 캔들스틱 항목을 차트에서 더블 클릭하면 이 신호가 발생합니다.
[signal] void QCandlestickSeries::hovered(bool status, QCandlestickSet *set)
이 신호는 차트에서 ` set `로 지정된 캔들스틱 항목 위에 마우스를 올렸을 때 발생합니다.
마우스가 항목 위로 이동하면 status 는 true 로 변경되고, 마우스가 다시 이동하면 false 로 변경됩니다.
[signal] void QCandlestickSeries::increasingColorChanged()
이 신호는 캔들스틱 항목의 상승 색상이 변경될 때 발생합니다.
참고: 속성 increasingColor 에 대한알림 신호입니다.
increasingColor도 참조하십시오 .
bool QCandlestickSeries::insert(int index, QCandlestickSet *set)
set 로 지정된 캔들스틱 항목을 index 로 지정된 위치의 시리즈에 삽입합니다. 해당 항목의 소유권을 가져옵니다. 항목이 null이거나 이미 해당 시리즈에 속해 있는 경우 삽입되지 않습니다. 삽입에 성공하면 true 를 반환하고, 그렇지 않으면 false 를 반환합니다.
[signal] void QCandlestickSeries::maximumColumnWidthChanged()
이 신호는 캔들스틱 항목의 최대 열 너비가 변경될 때 발생합니다.
참고: 속성 maximumColumnWidth 에 대한알림 신호입니다.
maximumColumnWidth도 참조하십시오 .
[signal] void QCandlestickSeries::minimumColumnWidthChanged()
이 신호는 캔들스틱 항목의 최소 열 너비가 변경될 때 발생합니다.
참고: 속성 minimumColumnWidth 에 대한알림 신호입니다.
minimumColumnWidth도 참조하십시오 .
[signal] void QCandlestickSeries::penChanged()
이 신호는 캔들스틱 항목의 펜이 변경될 때 발생합니다.
참고: 속성 pen 에 대한알림 신호입니다.
pen도 참조하십시오 .
[signal] void QCandlestickSeries::pressed(QCandlestickSet *set)
이 신호는 사용자가 ` set `로 지정된 캔들스틱 항목을 클릭한 후 마우스 버튼을 누르고 있을 때 발생합니다.
[signal] void QCandlestickSeries::released(QCandlestickSet *set)
이 신호는 사용자가 ` set`로 지정된 캔들스틱 항목에서 마우스 버튼을 놓을 때 발생합니다.
bool QCandlestickSeries::remove(QCandlestickSet *set)
set 로 지정된 단일 캔들스틱 항목을 시계열에서 제거합니다. 항목이 성공적으로 삭제되면 true 를 반환하고, 그렇지 않은 경우 false 를 반환합니다.
bool QCandlestickSeries::remove(const QList<QCandlestickSet *> &sets)
sets 로 지정된 캔들스틱 항목 목록을 시계열에서 제거합니다. 항목 중 하나라도 null이거나, 이미 시계열에서 제거되었거나, 목록에 두 번 이상 포함된 경우 아무것도 제거되지 않습니다. 모든 항목이 성공적으로 제거된 경우 true 를 반환하고, 그렇지 않은 경우 false 를 반환합니다.
QList<QCandlestickSet *> QCandlestickSeries::sets() const
시리즈에 포함된 캔들스틱 항목의 목록을 반환합니다. 항목의 소유권은 변경되지 않습니다.
bool QCandlestickSeries::take(QCandlestickSet *set)
시리즈에서 ` set`로 지정된 단일 캔들스틱 항목을 가져옵니다. 해당 항목은 삭제되지 않습니다. 가져오기 작업이 성공하면 ` true `를 반환하고, 그렇지 않으면 ` false `를 반환합니다.
참고: 시리는 해당 항목의 상위 객체로 유지됩니다. 완전한 소유권을 확보하려면 상위 객체를 설정해야 합니다.
[override virtual] QAbstractSeries::SeriesType QCandlestickSeries::type() const
QAbstractSeries::type 속성에 대한 액세스 함수를 재구현합니다.
시리즈의 유형을 반환합니다 (QAbstractSeries::SeriesTypeCandlestick).
© 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.