BarCategoryAxis QML Type

그래프의 축에 카테고리를 추가합니다. 더 보기...

Import Statement:	`import QtGraphs`
In C++:	QBarCategoryAxis
Inherits:	AbstractAxis

상속된 멤버를 포함한 모든 멤버 목록
BarCategoryAxis는 Qt Graphs 2D용 QML 유형에 속합니다.

속성

categories : list
count : int
max : string
min : string

신호

categoriesChanged()
categoryRangeChanged(string min, string max)
countChanged()
maxChanged(string max)
minChanged(string min)

방법

append(list categories)
append(string category)
string at(int index)
clear()
insert(int index, string category)
remove(int index)
remove(string category)
replace(string oldCategory, string newCategory)

상세 설명

바 카테고리 축 유형은 눈금선, 격자선 및 음영이 있는 축선을 표시하도록 설정할 수 있습니다. 카테고리는 눈금 사이에 그려집니다.

다음 QML 스니펫은 BarCategoryAxis를 사용하는 방법을 보여줍니다:

GraphsView {
    anchors.fill: parent
    axisX: BarCategoryAxis {
        categories: ["2023", "2024", "2025"]
        lineVisible: false
    }
    axisY: ValueAxis { }
    BarSeries {
        BarSet {
            values: [7, 6, 9]
        }
    }
}

속성 문서

categories : list

축의 카테고리입니다.

count : int [read-only]

축의 카테고리 수입니다.

max : string

축의 최대값입니다. 지정된 값은 categories 에 포함되어야 합니다.

min : string

축의 최소값입니다. 주어진 값은 categories 에 포함되어야 합니다.

신호 문서

categoriesChanged()

이 신호는 축의 카테고리가 변경될 때 발생합니다.

참고: 해당 핸들러는 onCategoriesChanged 입니다.

categoryRangeChanged(string min, string max)

이 신호는 축의 카테고리 범위가 변경될 때 발생합니다. min 및 max 은 새 범위의 최소값과 최대값입니다.

참고: 해당 핸들러는 onCategoryRangeChanged 입니다.

countChanged()

이 신호는 축의 카테고리 수가 변경될 때 발생합니다.

참고: 해당 핸들러는 onCountChanged 입니다.

maxChanged(string max)

이 신호는 축 최대값이 max 로 변경될 때 발생합니다.

참고: 해당 핸들러는 onMaxChanged 입니다.

minChanged(string min)

이 신호는 축 최소값이 min 으로 변경될 때 발생합니다.

참고: 해당 핸들러는 onMinChanged 입니다.

메서드 문서

append(list categories)

축에 categories 을 추가합니다. 축의 최대값은 categories 의 마지막 카테고리와 일치하도록 변경됩니다. 이전에 정의된 카테고리가 없는 경우 축의 최소값도 categories 의 첫 번째 카테고리와 일치하도록 변경됩니다.

카테고리는 유효한 QString 이어야 하며 중복될 수 없습니다. 중복된 카테고리는 추가되지 않습니다.

append(string category)

축에 category 을 추가합니다. 축의 최대값은 마지막 category 과 일치하도록 변경됩니다. 이전에 정의된 카테고리가 없는 경우 축의 최소값도 category 와 일치하도록 변경됩니다.

카테고리는 유효한 QString 이어야 하며 중복될 수 없습니다. 중복된 카테고리는 추가되지 않습니다.

string at(int index)

index 에서 카테고리를 반환합니다.

clear()

모든 카테고리를 제거합니다. 축 범위의 최대값과 최소값을 QString::null로 설정합니다.

insert(int index, string category)

index 의 축에 category 을 삽입합니다. category 은 유효한 QString 이어야 하며 중복될 수 없습니다. category 을 다른 카테고리에 앞에 붙이거나 추가하면 축의 최소값과 최대값이 그에 따라 업데이트됩니다.

remove(int index)

축에서 index 카테고리를 제거합니다. 현재 축의 최대값 또는 최소값을 설정하고 있는 카테고리를 제거하면 축 범위에 영향을 미칩니다.

remove(string category)

축에서 category 을 제거합니다. 현재 축의 최대값 또는 최소값을 설정하는 카테고리를 제거하면 축 범위에 영향을 줍니다.

replace(string oldCategory, string newCategory)

oldCategory 을 newCategory 으로 바꿉니다. 축에 oldCategory 이 존재하지 않으면 아무 작업도 수행되지 않습니다. newCategory 은 유효한 QString 이어야 하며 중복될 수 없습니다. 최소 또는 최대 카테고리를 바꾸면 축의 최소값과 최대값이 그에 따라 업데이트됩니다.

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