Back to Qt.io
Contact Us Blog Download Qt

CandlestickSeries QML Type

일련의 데이터를 캔들 스틱으로 표시합니다. 더 보기...

Import Statement: import QtCharts 2.8
Since: QtCharts 2.2
In C++: QCandlestickSeries
Inherits:

AbstractSeries

속성

신호

방법

상세 설명

캔들스틱 시리즈 유형은 단일 캔들스틱 항목을 담는 컨테이너 역할을 합니다. 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 및 ValueAxis 을참조하십시오 .


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 입니다.


메서드 문서

append(CandlestickSet set)

set 으로 지정된 단일 캔들스틱 항목을 시리즈에 추가하고 해당 항목의 소유권을 가져옵니다. 항목이 null이거나 이미 시리즈에 있는 경우 추가되지 않습니다.

추가에 성공하면 true, 그렇지 않으면 false 을 반환합니다.


at(int index)

index 에 지정된 위치에 있는 캔들스틱 항목을 반환합니다. 인덱스가 유효하지 않으면 null을 반환합니다.


clear()

시리즈에서 모든 캔들 스틱 항목을 제거하고 영구적으로 삭제합니다.


insert(int index, CandlestickSet set)

set 으로 지정한 캔들스틱 항목을 index 으로 지정한 위치에 시리즈에 삽입합니다. 항목의 소유권을 가져옵니다. 항목이 null이거나 이미 시리즈에 속해 있으면 삽입되지 않습니다.

삽입에 성공하면 true, 그렇지 않으면 false 을 반환합니다.


remove(CandlestickSet set)

set 로 지정된 단일 캔들스틱 항목을 시리즈에서 제거합니다.

항목이 성공적으로 삭제되면 true, 그렇지 않으면 false 을 반환합니다.


© 2025 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.