Класс QValue3DAxisFormatter

Класс QValue3DAxisFormatter является базовым классом для форматеров осей значений. Подробнее...

Этот класс был представлен в QtDataVisualization 1.1.

• Список всех членов, включая унаследованные

Открытые функции

Защищённые функции

Подробное описание

Этот класс предоставляет правила форматирования для линейной оси значений 3D. Наследуйте его, если хотите реализовать пользовательские оси значений.

Базовый класс не имеет публичного API за пределами конструкторов и деструкторов. Он предназначен только для внутреннего использования. Однако подклассы могут реализовывать публичные свойства по мере необходимости.

См. также QValue3DAxis и QLogValue3DAxisFormatter.

Документация по членам-функциям

QValue3DAxisFormatter::QValue3DAxisFormatter(QObject *parent = nullptr)

Создаёт новый форматер оси значений 3D с необязательным родителем parent.

[virtual] QValue3DAxisFormatter::~QValue3DAxisFormatter()

Удаляет форматер оси значений 3D.

[protected] bool QValue3DAxisFormatter::allowNegatives() const

Возвращает true, если отрицательные значения являются допустимыми значениями для родительской оси. Реализация по умолчанию всегда возвращает true.

См. также setAllowNegatives().

[protected] bool QValue3DAxisFormatter::allowZero() const

Возвращает true, если ноль является допустимым значением для родительской оси. Реализация по умолчанию всегда возвращает true.

См. также setAllowZero().

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

Возвращает родительскую ось. Доступ к родительской оси должен осуществляться только в методе recalculate() для обеспечения безопасности потоков в средах, использующих многопоточный рендеринг.

См. также recalculate().

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

Создаёт новый пустой форматер оси значений 3D. Должен быть переопределён в подклассе.

Возвращает новый форматер. Рендеринг использует этот метод для кеширования копии форматера. Владение новой копией передаётся вызывающему коду.

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

Возвращает ссылку на массив нормализованных положений линий сетки. Размер массива по умолчанию равен количеству сегментов родительской оси плюс один, но подклассы могут изменить размер массива, переопределив метод recalculate(). Значения должны быть в пределах от 0.0 (минимальное значение) до 1.0 (максимальное значение), включительно.

См. также QValue3DAxis::segmentCount и recalculate().

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

Возвращает ссылку на массив нормализованных положений меток. Размер массива по умолчанию равен количеству сегментов родительской оси плюс один, но подклассы могут изменить размер массива, переопределив метод recalculate(). Значения должны быть в пределах от 0.0 (минимальное значение) до 1.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

Копирует все необходимые значения для определения позиций, значений и строк с этим форматомтер в копию форматера. При переопределении этого метода в подклассе, вызовите версию суперкласса в какой-то момент. Рендерер использует этот метод для кэширования копии форматера.

Возвращает новую копию. Владение новой копией передается вызывающей стороне.

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

См. также allowZero().

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

Устанавливает locale, который использует этот форматер. График автоматически устанавливает locale форматера на locale графика всякий раз, когда родительская ось устанавливается как активная ось графика, форматер оси устанавливается на ось, присоединённую к графику, или изменяется locale графика.

См. также locale() и QAbstract3DGraph::locale.

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

Возвращает отформатированную строку метки, используя указанное value и format.

Переопределите этот метод в подклассе, чтобы определить отформатированную строку для заданного value, если правила форматирования по умолчанию, указанные для свойства QValue3DAxis::labelFormat, недостаточны.

См. также recalculate(), labelStrings() и QValue3DAxis::labelFormat.

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

Возвращает ссылку на массив нормализованных позиций линий субсетки. Размер массива по умолчанию равен количеству сегментов родительской оси умноженному на количество подсегментов родительской оси минус один, но подкласс реализации метода 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().