CandlestickSeries QML Type
일련의 데이터를 캔들 스틱으로 표시합니다. 더 보기...
| Import Statement: | import QtCharts 2.11 |
| Since: | QtCharts 2.2 |
| In C++: | QCandlestickSeries |
| Inherits: |
속성
- axisX : AbstractAxis
- axisXTop : AbstractAxis
- axisY : AbstractAxis
- axisYRight : AbstractAxis
- bodyOutlineVisible : bool
- bodyWidth : real
- brushFilename : string
- capsVisible : bool
- capsWidth : real
- count : int
- decreasingColor : color
- increasingColor : color
- maximumColumnWidth : real
- minimumColumnWidth : real
신호
- candlestickSetsAdded(list<CandlestickSet> sets)
- candlestickSetsRemoved(list<CandlestickSet> sets)
- clicked(CandlestickSet set)
- doubleClicked(CandlestickSet set)
- hovered(bool status, CandlestickSet set)
- pressed(CandlestickSet set)
- released(CandlestickSet set)
방법
- bool append(CandlestickSet set)
- CandlestickSet at(int index)
- void clear()
- bool insert(int index, CandlestickSet set)
- bool remove(CandlestickSet set)
상세 설명
캔들스틱 시리즈 유형은 단일 캔들스틱 항목을 담는 컨테이너 역할을 합니다. BarCategoryAxis 를 사용할 경우 각 항목은 고유한 카테고리로 그려집니다. DateTimeAxis 및 ValueAxis 는 BarCategoryAxis 의 대안으로 사용할 수 있습니다. 이 경우 각 캔들스틱 항목은 타임스탬프 값에 따라 그려집니다.
참고: 타임스탬프는 캔들 시리즈 내에서 고유해야 합니다. BarCategoryAxis 을 사용하는 경우 타임스탬프를 공유하는 캔들스틱 항목 중 첫 번째 항목만 그려집니다. 차트에 캔들스틱계열의 여러 인스턴스가 포함된 경우 타임스탬프를 공유하는 다른 계열의 항목이 같은 카테고리에 그려집니다. ValueAxis 또는 DateTimeAxis 을 사용하는 경우 타임스탬프를 공유하는 캔들스틱 항목은 서로 겹치게 됩니다.
다음 QML은 간단한 캔들스틱 차트를 만드는 방법을 보여줍니다:
import QtQuick 2.5 import QtCharts 2.2 ChartView { title: "Candlestick Series" width: 400 height: 300 CandlestickSeries { name: "Acme Ltd." increasingColor: "green" decreasingColor: "red" CandlestickSet { timestamp: 1435708800000; open: 690; high: 694; low: 599; close: 660 } CandlestickSet { timestamp: 1435795200000; open: 669; high: 669; low: 669; close: 669 } CandlestickSet { timestamp: 1436140800000; open: 485; high: 623; low: 485; close: 600 } CandlestickSet { timestamp: 1436227200000; open: 589; high: 615; low: 377; close: 569 } CandlestickSet { timestamp: 1436313600000; open: 464; high: 464; low: 254; close: 254 } } }

CandlestickSet, BarCategoryAxis, DateTimeAxis, ValueAxis도 참조 하세요.
속성 문서
axisX : AbstractAxis
시리즈에 사용되는 x축입니다. 축X와 axisXTop 를 모두 정의하지 않으면 계열에 대한 값 축이 만들어집니다.
axisXTop : AbstractAxis
차트 뷰 위에 그려지는 시리즈에 사용되는 X축입니다.
참고: axisX 또는 axisXTop 중 하나만 제공할 수 있으며 둘 다 제공할 수는 없습니다.
axisX 를참조하세요 .
axisY : AbstractAxis
시리즈에 사용되는 Y축입니다. Y축과 axisYRight 축을 모두 정의하지 않으면 계열에 대한 값 축이 만들어집니다.
axisYRight 및 ValueAxis 을참조하세요 .
axisYRight : AbstractAxis
차트 보기에서 오른쪽에 그려지는 시리즈에 사용되는 Y축입니다.
참고: axisY 또는 axisYRight 중 하나만 제공할 수 있으며 둘 다 제공할 수는 없습니다.
axisY 를참조하세요 .
bodyOutlineVisible : bool
캔들 스틱 본체의 윤곽이 표시됩니다.
bodyWidth : real
자체 슬롯 내에서 캔들스틱 항목의 상대적 너비(0.0~1.0 범위)입니다. 이 범위를 벗어나는 값은 0.0 또는 1.0으로 고정됩니다.
brushFilename : string
시리즈의 브러시 이미지로 사용되는 파일의 이름입니다.
capsVisible : bool
캡의 가시성.
capsWidth : real
캔들스틱 내 캡의 상대적 너비(0.0~1.0 범위)입니다. 이 범위를 벗어난 값은 0.0 또는 1.0으로 고정됩니다.
count : int [read-only]
시리즈에 있는 캔들스틱 항목 수입니다.
decreasingColor : color
감소하는 캔들 종목 몸통의 색상입니다. 캔들스틱의 시가 값이 종가 값보다 높으면 캔들스틱이 감소하는 것입니다. 기본적으로 이 속성은 알파 채널이 128로 설정된 브러시 색상으로 설정됩니다. 프로퍼티가 잘못된 색상 값으로 설정된 경우에도 기본 색상이 사용됩니다.
increasingColor : color
상승 중인 캔들 종목 몸통의 색상입니다. 종가 값이 시가보다 높으면 캔들스틱이 상승하는 것입니다. 기본적으로 이 속성은 브러시 색상으로 설정됩니다. 속성이 잘못된 색상 값으로 설정된 경우에도 기본 색상이 사용됩니다.
maximumColumnWidth : real
캔들 스틱 항목의 최대 너비(픽셀 단위)입니다. 음수 값을 설정하면 최대 너비가 없습니다. 모든 음수 값은 -1.0으로 변환됩니다.
minimumColumnWidth : real
캔들 스틱 항목의 최소 너비(픽셀 단위)입니다. 음수 값을 설정하면 최소 너비가 없습니다. 모든 음수 값은 -1.0으로 변환됩니다.
신호 문서
candlestickSetsAdded(list<CandlestickSet> sets)
이 신호는 sets 에 지정된 캔들스틱 항목이 시리즈에 추가될 때 발신됩니다.
해당 신호 핸들러는 onCandlestickSetsAdded 입니다.
참고: 해당 핸들러는 onCandlestickSetsAdded 입니다.
candlestickSetsRemoved(list<CandlestickSet> sets)
이 신호는 sets 에서 지정한 캔들스틱 항목이 시리즈에서 제거될 때 발산됩니다.
해당 신호 핸들러는 onCandlestickSetsRemoved 입니다.
참고: 해당 핸들러는 onCandlestickSetsRemoved 입니다.
clicked(CandlestickSet set)
이 신호는 차트에서 set 에 지정된 캔들 스틱 항목을 클릭하면 발산됩니다.
해당 신호 핸들러는 onClicked 입니다.
참고: 해당 핸들러는 onClicked 입니다.
doubleClicked(CandlestickSet set)
이 신호는 차트에서 set 에 지정된 캔들 스틱 항목을 더블 클릭하면 발산됩니다.
해당 신호 핸들러는 onDoubleClicked 입니다.
참고: 해당 핸들러는 onDoubleClicked 입니다.
hovered(bool status, CandlestickSet set)
이 신호는 차트에서 set 으로 지정된 캔들스틱 항목 위에 마우스를 가져가면 발산됩니다.
마우스가 항목 위로 이동하면 status 이 true 으로 바뀌고, 마우스가 다시 멀어지면 false 으로 바뀝니다.
해당 신호 핸들러는 onHovered 입니다.
참고: 해당 핸들러는 onHovered 입니다.
pressed(CandlestickSet set)
이 신호는 사용자가 set 에 지정된 캔들 스틱 항목을 클릭하고 마우스 버튼을 누르고 있을 때 발생합니다.
해당 신호 핸들러는 onPressed 입니다.
참고: 해당 핸들러는 onPressed 입니다.
released(CandlestickSet set)
이 신호는 사용자가 set 에 지정된 캔들 스틱 항목에서 마우스를 놓을 때 발생합니다.
해당 신호 핸들러는 onReleased 입니다.
참고: 해당 핸들러는 onReleased 입니다.
메서드 문서
bool append(CandlestickSet set)
set 으로 지정된 단일 캔들 스틱 항목을 시리즈에 추가하고 소유권을 가져옵니다. 항목이 null이거나 이미 시리즈에 있는 경우 추가되지 않습니다.
추가에 성공하면 true, 그렇지 않으면 false 을 반환합니다.
CandlestickSet at(int index)
index 에 지정된 위치의 캔들스틱 항목을 반환합니다. 인덱스가 유효하지 않으면 null을 반환합니다.
void clear()
시리즈에서 모든 캔들 스틱 항목을 제거하고 영구적으로 삭제합니다.
bool insert(int index, CandlestickSet set)
set 에서 지정한 캔들스틱 항목을 index 에서 지정한 위치의 시리즈에 삽입합니다. 항목의 소유권을 가져옵니다. 항목이 null이거나 이미 시리즈에 속해 있으면 삽입되지 않습니다.
삽입에 성공하면 true, 그렇지 않으면 false 을 반환합니다.
bool remove(CandlestickSet set)
set 으로 지정된 단일 캔들스틱 항목을 시리즈에서 제거합니다.
항목이 성공적으로 삭제되면 true, 그렇지 않으면 false 을 반환합니다.
© 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.