QValue3DAxisFormatter Class

멤버 함수 문서

[explicit] QValue3DAxisFormatter::QValue3DAxisFormatter(QObject *parent = nullptr)

선택적 상위 요소인 parent 을 사용하여 새로운 3D 축 포맷터를 생성합니다.

[override virtual noexcept] QValue3DAxisFormatter::~QValue3DAxisFormatter()

3D 축 서식 지정기의 값을 삭제합니다.

[protected] bool QValue3DAxisFormatter::allowNegatives() const

부모 축에서 음수 값이 유효한 값인 경우 ` true `를 반환합니다. 기본 구현은 항상 ` true`를 반환합니다.

setAllowNegatives()도 참조하십시오 .

[protected] bool QValue3DAxisFormatter::allowZero() const

‘zero’가 부모 축에 대해 유효한 값인 경우 true 를 반환합니다. 기본 구현은 항상 true 를 반환합니다.

setAllowZero()도 참조하십시오 .

[protected] QValue3DAxis *QValue3DAxisFormatter::axis() const

상위 축을 반환합니다. 스레드 기반 렌더러를 사용하는 환경에서 스레드 안전성을 유지하려면, 상위 축은 반드시 ` recalculate()` 메서드 내에서만 접근해야 합니다.

recalculate()도 참조하십시오 .

[virtual protected] QValue3DAxisFormatter *QValue3DAxisFormatter::createNewInstance() const

새로운 빈 값 3D 축 포맷터를 생성합니다. 하위 클래스에서 재구현해야 합니다.

새로운 포맷터를 반환합니다. 렌더러는 이 메서드를 사용하여 포맷터의 복사본을 캐시에 저장합니다. 새 복사본의 소유권은 호출자에게 이전됩니다.

[protected] QList<float> QValue3DAxisFormatter::gridPositions() &&

값별로 정규화된 격자선 위치의 배열을 반환합니다. 기본 배열 크기는 상위 축의 세그먼트 수에 1을 더한 값과 같지만, ` recalculate()` 메서드의 하위 클래스 구현에서는 배열 크기를 다르게 조정할 수 있습니다.

QValue3DAxis::segmentCount 및 recalculate()도 참조하십시오 .

[protected] const QList<float> &QValue3DAxisFormatter::gridPositions() const &

정규화된 격자선 위치 배열에 대한 참조를 반환합니다. 배열의 기본 크기는 상위 축의 세그먼트 수에 1을 더한 값과 같지만, ` recalculate()` 메서드의 서브클래스 구현에서는 배열 크기를 다르게 조정할 수 있습니다.

QValue3DAxis::segmentCount 및 recalculate()도 참조하십시오 .

[protected] QList<float> QValue3DAxisFormatter::labelPositions() &&

값별로 정규화된 레이블 위치의 배열을 반환합니다. 기본 배열 크기는 부모 축의 세그먼트 수에 1을 더한 값과 같지만, ` recalculate()` 메서드의 서브클래스 구현에서는 배열 크기를 다르게 조정할 수 있습니다. 기본적으로 인덱스 0에 있는 레이블은 해당 축의 최소값에 해당합니다.

QValue3DAxis::segmentCount, QAbstract3DAxis::labels 및 recalculate()도 참조하십시오 .

[protected] const QList<float> &QValue3DAxisFormatter::labelPositions() const &

정규화된 레이블 위치 배열에 대한 참조를 반환합니다. 배열의 기본 크기는 부모 축의 세그먼트 수에 1을 더한 값과 같지만, ` recalculate()` 메서드의 하위 클래스 구현에서는 배열 크기를 다르게 조정할 수 있습니다. 기본적으로 인덱스 0에 있는 레이블은 해당 축의 최소값에 해당합니다.

QValue3DAxis::segmentCount, QAbstract3DAxis::labels 및 recalculate()도 참조하십시오 .

[protected] QStringList QValue3DAxisFormatter::labelStrings() &&

포맷터 레이블 문자열을 포함하는 문자열 목록을 값으로 반환합니다.

setLabelStrings() 및 labelPositions()도 참조하십시오 .

[protected] const QStringList &QValue3DAxisFormatter::labelStrings() const &

포맷터 레이블 문자열이 포함된 문자열 목록에 대한 참조를 반환합니다.

labelPositions()도 참조하십시오 .

[protected] QLocale QValue3DAxisFormatter::locale() const

이 포맷터가 현재 사용하고 있는 로케일을 반환합니다.

setLocale()도 참조하십시오 .

[protected] void QValue3DAxisFormatter::markDirty(bool labelsChange = false)

이 포맷터를 '변경됨' 상태로 표시하여, 다음 렌더러 동기화 시 렌더러가 캐시의 새 사본을 생성하도록 합니다. 이 메서드는 포맷터가 변경되어 해결된 값에 영향을 미치는 경우, 하위 클래스에서 호출해야 합니다. 변경 사항으로 인해 상위 축 레이블 문자열을 다시 생성해야 하는 경우, ` labelsChange `를 ` true `으로 설정하십시오.

[virtual protected] void QValue3DAxisFormatter::populateCopy(QValue3DAxisFormatter &copy)

이 포맷터를 사용하여 위치, 값 및 문자열을 해결하는 데 필요한 모든 값을 포맷터의 ` copy `에 복사합니다. 하위 클래스에서 이 메서드를 재구현할 때는 적절한 시점에 슈퍼클래스의 버전을 호출해야 합니다. 렌더러는 이 메서드를 사용하여 포맷터의 복사본을 캐시합니다.

새로운 복사본을 반환합니다. 새로운 복사본의 소유권은 호출자에게 이전됩니다.

[virtual protected] float QValue3DAxisFormatter::positionAt(float value) const

주어진 ` value`에 대해 축을 따라 정규화된 위치를 반환합니다. 반환된 값은 해당 값이 상위 축의 범위 내에 있는 경우, ` 0.0 `(최소값)과 ` 1.0 `(최대값) 사이여야 하며, 이 두 값은 포함됩니다.

부모 축의 최소값과 최대값 사이의 선형 보간으로 위치를 계산할 수 없는 경우, 이 메서드를 재구현하십시오.

recalculate() 및 valueAt()도 참조하십시오 .

[virtual protected] void QValue3DAxisFormatter::recalculate()

레이블 및 격자선 위치 배열과 레이블 문자열 배열의 크기를 조정하고 값을 채우며, 값을 해당 위치에 매핑하는 데 필요한 모든 값을 계산합니다. 이 함수 내부에서 상위 축에 접근할 수 있습니다.

기본 배열의 내용이 적합하지 않은 경우, 이 메서드는 하위 클래스에서 재구현해야 합니다.

크기 조정 및 값을 채워야 하는 배열에 대한 설명은 gridPositions(), subGridPositions(), labelPositions() 및 labelStrings() 메서드 문서를 참조하십시오.

또한 gridPositions(), subGridPositions(), labelPositions(), labelStrings() 및 axis()을 참조하십시오 .

[protected] void QValue3DAxisFormatter::setAllowNegatives(bool allow)

allow 가 true 인 경우, 상위 축에 음수 값이 허용됩니다.

allowNegatives()도 참조하십시오 .

[protected] void QValue3DAxisFormatter::setAllowZero(bool allow)

allow 가 true 인 경우, 상위 축의 값이 0이 되도록 허용합니다.

allowZero()도 참조하십시오 .

[protected] void QValue3DAxisFormatter::setGridPoitions(QList<float> gridPositions)

gridPositions 에서 가져온 새로운 그리드 위치 목록을 설정합니다. 값은 0.0 (최소값)과 1.0 (최대값) 사이여야 하며, 이 두 값을 포함합니다.

QValue3DAxis::segmentCount, recalculate(), gridPositions도 참조하십시오 .

[protected] void QValue3DAxisFormatter::setLabelStrings(QStringList labelStrings)

labelStrings 에서 가져온 새로운 레이블 문자열 목록을 설정합니다. 배열의 크기는 레이블 위치 배열의 크기와 같아야 하며, 인덱스도 이에 대응해야 합니다.

labelPositions() 및 labelStrings()도 참조하십시오 .

[protected] void QValue3DAxisFormatter::setLocale(const QLocale &locale)

이 포맷터가 사용하는 로케일( locale )을 설정합니다. 부모 축이 그래프의 활성 축으로 설정되거나, 축 포맷터가 그래프에 연결된 축으로 설정되거나, 그래프의 로케일이 변경될 때마다 그래프는 포맷터의 로케일을 그래프의 로케일로 자동으로 설정합니다.

locale() 및 Q3DGraphsWidgetItem::locale도 참조하십시오 .

[protected] void QValue3DAxisFormatter::setSubGridPositions(QList<float> subGridPositions)

subGridPositions 에서 새로운 하위 그리드 위치 목록을 설정합니다. 값은 0.0 (최소값)과 1.0 (최대값) 사이의 값이어야 하며, 이 두 값을 포함합니다.

QValue3DAxis::segmentCount, QValue3DAxis::subSegmentCount, recalculate(), subGridPositions도 참조하십시오 .

[protected] void QValue3DAxisFormatter::setlabelPositions(QList<float> labelPositions)

labelPositions 에서 가져온 새로운 레이블 위치 목록을 설정합니다. 값은 0.0 (최소값)부터 1.0 (최대값)까지여야 하며, 이 두 값을 포함합니다.

QValue3DAxis::segmentCount, QAbstract3DAxis::labels, recalculate(), labelPositions()도 참조하십시오 .

[virtual protected] QString QValue3DAxisFormatter::stringForValue(qreal value, const QString &format)

지정된 ` value ` 및 ` format`을 사용하여 서식이 지정된 레이블 문자열을 반환합니다.

QValue3DAxis::labelFormat 속성에 지정된 기본 서식 규칙만으로는 충분하지 않은 경우, 하위 클래스에서 이 메서드를 재구현하여 주어진 value 에 대한 서식 처리된 문자열을 생성할 수 있습니다.

recalculate(), labelStrings(), QValue3DAxis::labelFormat도 참조하십시오 .

[protected] QList<float> QValue3DAxisFormatter::subGridPositions() &&

값별로 정규화된 서브 그리드 선 위치의 배열을 반환합니다. 기본 배열 크기는 부모 축의 세그먼트 수에 부모 축의 서브 세그먼트 수를 곱한 값에서 1을 뺀 값과 같지만, ` recalculate()` 메서드의 서브클래스 구현에서는 배열 크기를 다르게 조정할 수 있습니다.

setSubGridPositions(), QValue3DAxis::segmentCount, QValue3DAxis::subSegmentCount 및 recalculate()도 참조하십시오 .

[protected] const QList<float> &QValue3DAxisFormatter::subGridPositions() const &

정규화된 서브 그리드 선 위치 배열에 대한 참조를 반환합니다. 기본 배열 크기는 부모 축의 세그먼트 수에 부모 축의 서브세그먼트 수를 곱한 값에서 1을 뺀 값과 같지만, ` recalculate()` 메서드의 서브클래스 구현에서는 배열 크기를 다르게 조정할 수 있습니다.

QValue3DAxis::segmentCount, QValue3DAxis::subSegmentCount 및 recalculate()도 참조하십시오 .

[virtual protected] float QValue3DAxisFormatter::valueAt(float position) const

축을 따라 정규화된 좌표 position 에 해당하는 값을 반환합니다. 부모 축의 범위 내 값을 얻으려면 position 값이 0.0 (최소값)과 1.0 (최대값) 사이(양쪽 끝 포함)여야 합니다.

부모 축의 최소값과 최대값 사이의 선형 보간으로 값을 구할 수 없는 경우 이 메서드를 재구현하십시오.

recalculate() 및 positionAt()도 참조하십시오 .