CandlestickSeries QML Type
일련의 데이터를 캔들스틱 형태로 표시합니다. 더 보기...
| Import Statement: | import QtCharts 2.12 |
| Since: | QtCharts 2.2 |
| In C++: | QCandlestickSeries |
| Inherits: | |
| Status: | Deprecated |
이 유형은 더 이상 권장되지 않습니다. 새로운 코드에서는 이 유형을 사용하지 않도록 강력히 권장합니다.
속성
- 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)
상세 설명
CandlestickSeries 유형은 개별 캔들스틱 항목을 담는 컨테이너 역할을 합니다. BarCategoryAxis 를 사용할 경우, 각 항목은 자체 카테고리에 그려집니다. BarCategoryAxis 대신 DateTimeAxis 및 ValueAxis 를 사용할 수 있습니다. 이 경우, 각 캔들스틱 항목은 타임스탬프 값에 따라 그려집니다.
참고: 타임스탬프는 CandlestickSeries 내에서 고유해야 합니다. BarCategoryAxis 를 사용할 경우, 동일한 타임스탬프를 공유하는 캔들스틱 항목 중 첫 번째 항목만 그려집니다. 차트에 여러 개의 CandlestickSeries 인스턴스가 포함된 경우, 서로 다른 시리즈에 속하지만 동일한 타임스탬프를 공유하는 항목들은 동일한 범주에 그려집니다. 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축입니다. axisX와 axisXTop 를 모두 정의하지 않으면, 시리즈에 값 축이 생성됩니다.
axisXTop 및 ValueAxis항목도 참조하십시오 .
axisXTop : AbstractAxis
차트 뷰 위에 그려진, 해당 시리즈에 사용되는 x축입니다.
참고: axisX 와 axisXTop 중 하나만 지정할수 있으며 , 둘 다 지정할 수는 없습니다.
axisX항목도 참조하십시오 .
axisY : AbstractAxis
시리즈에 사용되는 y축입니다. axisY와 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으로 변환됩니다.
Signal 문서
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.