Класс QValue3DAxisFormatter

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

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

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

• 34 открытых функций, унаследованных от QObject

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

• 9 защищенных функций, унаследованных от QObject

Дополнительные наследуемые члены

• 1 свойство, унаследованное от QObject
• 1 открытый слот, унаследованный от QObject
• 2 сигнала, унаследованные от QObject
• 1 открытая переменная, унаследованная от QObject
• 10 статических открытых членов, унаследованных от QObject
• 2 защищенных переменных, унаследованных от QObject

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

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

Этот класс предоставляет правила форматирования для линейной оси значений 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

Копирует все необходимые значения для разрешения позиций, значений и строк с этим форматировщиком в копию форматировщика 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.

См. также 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().