이 페이지에서

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)

알림 신호:

bodyWidth : qreal

이 속성은 캔들스틱 항목이 해당 슬롯 내에서 차지하는 상대적 너비를 0.0에서 1.0 사이의 범위로 지정합니다.

이 범위 밖의 값은 0.0 또는 1.0으로 제한됩니다.

액세스 함수:

qreal bodyWidth() const
void setBodyWidth(qreal bodyWidth)

알림 신호:

brush : QBrush

이 속성은 캔들스틱 항목을 채우는 데 사용되는 브러시를 저장합니다.

액세스 함수:

QBrush brush() const
void setBrush(const QBrush &brush)

알림 신호:

void brushChanged()

capsVisible : bool

이 속성은 캡의 표시 여부를 결정합니다.

액세스 함수:

bool capsVisible() const
void setCapsVisible(bool capsVisible)

알림 신호:

capsWidth : qreal

이 속성은 캔들스틱 내 상단 및 하단 선의 상대적 너비를 0.0에서 1.0 사이의 범위로 지정합니다.

이 범위 밖의 값은 0.0 또는 1.0으로 제한됩니다.

액세스 함수:

qreal capsWidth() const
void setCapsWidth(qreal capsWidth)

알림 신호:

[read-only] count : int

이 속성은 시계열에 포함된 캔들스틱 항목의 개수를 나타냅니다.

액세스 함수:

int count() const

알림 신호:

void countChanged()

decreasingColor : QColor

이 속성은 하락 캔들스틱 항목의 본문 색상을 지정합니다.

캔들스틱은 시가 값이 종가 값보다 높을 때 하락 캔들스틱으로 간주됩니다. 기본적으로 이 속성은 알파 채널이 128로 설정된 브러시 색상으로 지정됩니다. 속성이 유효하지 않은 색상 값으로 설정된 경우에도 기본 색상이 사용됩니다.

액세스 함수:

QColor decreasingColor() const
void setDecreasingColor(const QColor &decreasingColor)

알림 신호:

increasingColor : QColor

이 속성은 상승 캔들스틱 항목의 몸통 색상을 지정합니다.

캔들스틱은 종가가 시가보다 높을 때 상승 캔들스틱으로 간주됩니다. 기본적으로 이 속성은 브러시 색상으로 설정되어 있습니다. 속성이 유효하지 않은 색상 값으로 설정된 경우에도 기본 색상이 사용됩니다.

액세스 함수:

QColor increasingColor() const
void setIncreasingColor(const QColor &increasingColor)

알림 신호:

maximumColumnWidth : qreal

이 속성은 캔들스틱 항목의 최대 너비를 픽셀 단위로 지정합니다. 음수 값을 설정하면 최대 너비가 없다는 의미입니다. 모든 음수 값은 -1.0으로 변환됩니다.

액세스 함수:

qreal maximumColumnWidth() const
void setMaximumColumnWidth(qreal maximumColumnWidth)

알림 신호:

minimumColumnWidth : qreal

이 속성은 캔들스틱 항목의 최소 너비를 픽셀 단위로 지정합니다. 음수 값을 설정하면 최소 너비가 없다는 의미입니다. 모든 음수 값은 -1.0으로 변환됩니다.

액세스 함수:

qreal minimumColumnWidth() const
void setMinimumColumnWidth(qreal minimumColumnWidth)

알림 신호:

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.