QValue3DAxisFormatter Class

멤버 함수 문서

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

선택적 상위 객체 parent 를 사용하여 새로운 값 기반 3D 축 서식 지정기를 생성합니다.

[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() const

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

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

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

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

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

[protected] 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) const

이 포맷터를 사용하여 위치, 값 및 문자열을 해결하는 데 필요한 모든 값을 포맷터의 ` 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::setLocale(const QLocale &locale)

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

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

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

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

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

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

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

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

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

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

축을 따라 정규화된 position 위치의 값을 반환합니다. 부모 축의 범위 내에서 값을 얻으려면, position 값이 0.0 (최소값)과 1.0 (최대값) 사이여야 하며, 이 두 값을 포함해야 합니다.

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

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