GraphsView QML Type

모든 Qt Graphs 뷰의 기본 유형입니다. 더 보기...

• 상속된 멤버를 포함한 모든 멤버 목록
• GraphsView는 2D용Qt Graphs QML 유형의 일부입니다.

속성

• axisX : AbstractAxis
• axisXSmoothing : real
• axisY : AbstractAxis
• axisYSmoothing : real
• clipPlotArea : bool (since 6.10)
• dynamicLabelMargins : bool
• gridSmoothing : real
• marginBottom : real
• marginLeft : real
• marginRight : real
• marginTop : real
• orientation : Qt.Orientation
• panStyle : enumeration (since 6.9)
• plotArea : rect (since 6.9)
• seriesList : list
• shadowBarWidth : real
• shadowColor : color
• shadowSmoothing : real
• shadowVisible : bool
• shadowXOffset : real
• shadowYOffset : real
• theme : GraphsTheme
• zoomAreaDelegate : Component (since 6.9)
• zoomAreaEnabled : bool (since 6.9)
• zoomSensitivity : real (since 6.9)
• zoomStyle : enumeration (since 6.9)

방법

• void addSeries(AbstractSeries series)
• bool hasSeries(AbstractSeries series)
• void insertSeries(int index, AbstractSeries series)
• void removeSeries(AbstractSeries series)
• void removeSeries(int index)

상세 설명

이 클래스는 시계열 데이터와 테마를 통합하여 그래프를 그립니다. 이 타입을 사용하려면 Qt Graphs 모듈을 임포트해야 합니다:

import QtGraphs

그 후 QML 파일에서 GraphsView를 사용할 수 있습니다:

import QtQuick
import QtGraphs

GraphsView {
    anchors.fill: parent
    theme: GraphsTheme {
        colorScheme: GraphsTheme.ColorScheme.Dark
        seriesColors: ["#E0D080", "#B0A060"]
        borderColors: ["#807040", "#706030"]
        grid.mainColor: "#ccccff"
        grid.subColor: "#eeeeff"
        axisY.mainColor: "#ccccff"
        axisY.subColor: "#eeeeff"
    }
    axisX: BarCategoryAxis {
        categories: ["2023", "2024", "2025"]
        lineVisible: false
    }
    axisY: ValueAxis {
        min: 0
        max: 10
        subTickCount: 4
    }
    BarSeries {
        BarSet {
            values: [7, 6, 9]
        }
        BarSet {
            values: [9, 8, 6]
        }
    }
}

BarSeries, LineSeries, BarCategoryAxis, ValueAxis 및 GraphsTheme도 참조하십시오 .

속성 설명서

axisX : AbstractAxis

이 뷰 내의 시계에 사용되는 x축입니다.

axisY도 참조하십시오 .

axisXSmoothing : real

그래프 X축의 부드러움(앤티앨리어싱) 정도를 조절합니다. 기본적으로 부드러움 수준은 1.0 입니다.

axisY : AbstractAxis

이 뷰 내의 시리즈에 사용되는 y축입니다.

axisX도 참조하십시오 .

axisYSmoothing : real

그래프 Y축의 부드러움(앤티앨리어싱) 정도를 조절합니다. 기본적으로 부드러움 수준은 1.0 입니다.

clipPlotArea : bool [since 6.10]

그래프 항목이 플롯 영역을 벗어나는 경우 잘라내야 하는지 여부를 제어합니다. 기본값은 ‘ true ’입니다.

이 속성은 Qt 6.10에서 도입되었습니다.

plotArea도 참조하십시오 .

dynamicLabelMargins : bool

이 속성은 레이블 여백이 동적으로 조정되는지 여부를 결정합니다.

기본적으로, 할당된 여백보다 넓은 레이블은 다른 그래프 요소와 겹치게 됩니다. 이 속성이 활성화되면 렌더러는 이러한 레이블을 위해 추가 공간을 확보하고, 겹침을 방지하기 위해 축의 위치를 재조정합니다.

gridSmoothing : real

그래프 격자의 평활화(앤티앨리어싱) 정도를 조절합니다. 기본적으로 평활화 수준은 1.0 입니다.

marginBottom : real

그래프 하단의 빈 공간 크기입니다. 기본적으로 여백은 20입니다.

marginLeft : real

그래프 왼쪽의 빈 공간의 크기입니다. 기본적으로 여백은 20입니다.

marginRight : real

그래프 오른쪽의 빈 공간의 크기입니다. 기본적으로 여백은 20입니다.

marginTop : real

그래프 상단의 빈 공간 크기입니다. 기본적으로 여백은 20입니다.

orientation : Qt.Orientation

GraphsView 의 방향을 결정합니다. 방향이 ‘ Qt.Horizontal ’일 경우, axisX 및 axisY 의 위치가 바뀌어 axisX 는 세로로, axisY 는 가로로 렌더링됩니다. 이 속성은 현재 BarSeries 에서 사용됩니다. 기본값은 Qt.Vertical 입니다.

panStyle : enumeration [since 6.9]

GraphsView 의 팬 스타일을 결정합니다. 팬 기능은 ValueAxis 의 pan 속성을 조작하여 작동합니다. 기본값은 GraphsView.PanStyle.None 입니다.

이 속성은 Qt 6.9에서 도입되었습니다.

plotArea : rect [read-only, since 6.9]

그래프가 그려지는 사각형입니다. 이는 GraphsView 영역에서 축 영역과 여백을 뺀 부분입니다.

이 속성은 Qt 6.9에서 도입되었습니다.

marginTop, marginBottom, marginLeft, marginRight도 참조하십시오 .

seriesList : list [read-only]

GraphsView 에 의해 렌더링되는 시리즈 목록입니다. GraphsView 의 시리즈 유형 자식 요소들로 자동으로 채워집니다.

이는 기본 속성이므로, 자식 요소들이 시리즈 목록에 자동으로 추가됩니다.

BarSeries, LineSeries 및 ScatterSeries도 참조하십시오 .

shadowBarWidth : real

그래프 격자 그림자의 너비를 제어합니다. 기본적으로 그림자 너비는 2.0 로 설정되어 있습니다.

shadowColor : color

그래프 격자 그림자 색상을 제어합니다. 기본적으로 그림자 색상은 ‘ black ’로 설정되어 있습니다.

shadowSmoothing : real

그래프 격자 그림자의 부드러움(앤티앨리어싱) 정도를 조절합니다. 기본적으로 그림자 부드러움은 ‘ 4.0 ’로 설정되어 있습니다.

shadowVisible : bool

그래프 격자 그림자가 표시될지 여부를 제어합니다. 기본적으로 그림자 표시 여부는 ‘ false ’로 설정되어 있습니다.

shadowXOffset : real

그래프 격자 그림자의 X축 오프셋을 제어합니다. 기본적으로 그림자의 X축 오프셋은 0.0 로 설정되어 있습니다.

shadowYOffset : real

그래프 격자 그림자의 Y 축 오프셋을 제어합니다. 기본적으로 그림자의 Y 축 오프셋은 0.0 로 설정되어 있습니다.

theme : GraphsTheme

그래프에 적용되는 테마입니다. 색상, 축선, 글꼴 등을 결정합니다. 테마가 설정되지 않은 경우 기본 테마가 사용됩니다.

zoomAreaDelegate : Component [since 6.9]

사용자가 특정 영역을 확대하기 위해 드래그 동작을 수행할 때 그려질 QML 요소를 지정합니다.

이 속성은 Qt 6.9에서 도입되었습니다.

zoomAreaEnabled : bool [since 6.9]

확대/축소 영역에서는 마우스 및 터치 드래그를 통해 ` zoomAreaDelegate`로 지정된 상자를 그립니다. 드래그를 해제하면 그래프의 ` ValueAxis ` 확대/축소 및 이동 속성이 변경되어, 뷰가 그려진 상자와 겹치는 영역만 표시되도록 합니다.

이 속성은 Qt 6.9에서 도입되었습니다.

zoomAreaDelegate도 참조하십시오 .

zoomSensitivity : real [since 6.9]

확대/축소 중에 확대/축소 값이 얼마나 빠르게 변하는지를 결정합니다.

이 속성은 Qt 6.9에서 도입되었습니다.

zoomStyle : enumeration [since 6.9]

GraphsView 의 확대/축소 스타일을 지정합니다. 확대/축소 기능은 ValueAxis 의 zoom 속성을 조작하여 작동합니다. 기본값은 GraphsView.ZoomStyle.None 입니다.

이 속성은 Qt 6.9에서 도입되었습니다.

메서드 문서

void addSeries(AbstractSeries series)

series 를 GraphsView 에 추가합니다. series 가 null인 경우 추가되지 않습니다. series 가 이미 그래프에 속해 있는 경우, 그래프의 맨 끝으로 이동됩니다.

bool hasSeries(AbstractSeries series)

series 가 그래프에 포함되어 있으면 ` true `를 반환합니다.

void insertSeries(int index, AbstractSeries series)

index 로 지정된 위치에 series 를 삽입합니다. series 가 null인 경우 삽입되지 않습니다. series 가 이미 그래프에 속해 있는 경우, index 로 이동됩니다.

void removeSeries(AbstractSeries series)

그래프에서 ` series `을 제거합니다.

void removeSeries(int index)

index 로 지정된 시계열을 그래프에서 제거합니다.