Qt 5.8 | Qt Charts | C++ Classes | QLogValueAxis

Qt 5.8.0 Reference Documentation

# QLogValueAxis Class

The QLogValueAxis class adds a logarithmic scale to a chart's axis. More...

Header: | #include <QLogValueAxis>
Instantiated By: | LogValueAxis
Inherits: | QAbstractAxis

- List of all members, including inherited members

## Properties

- base : qreal
- labelFormat : QString
- max : qreal
- min : qreal

- 27 properties inherited from QAbstractAxis

## Public Functions

| QLogValueAxis(QObject *parent = Q_NULLPTR)
| ~QLogValueAxis()
qreal | base() const
QString | labelFormat() const
qreal | max() const
qreal | min() const
void | setBase(qreal base)
void | setLabelFormat(const QString &format)
void | setMax(qreal max)
void | setMin(qreal min)
void | setRange(qreal min, qreal max)

## Reimplemented Public Functions

virtual AxisType | type() const

- 58 public functions inherited from QAbstractAxis

## Signals

void | baseChanged(qreal base)
void | labelFormatChanged(const QString &format)
void | maxChanged(qreal max)
void | minChanged(qreal min)
void | rangeChanged(qreal min, qreal max)

- 25 signals inherited from QAbstractAxis

## Detailed Description

The QLogValueAxis class adds a logarithmic scale to a chart's axis.

A logarithmic scale is a nonlinear scale that is based on orders of magnitude, so that each tick mark on the axis is the previous tick mark multiplied by a value.

Note: If QLogValueAxis is attached to a series with one or more points with negative or zero values on the associated dimension, the series will not be plotted at all. This is particularly relevant when XYModelMappers are used, since empty cells in models typically contain zero values.

## Property Documentation

### base : qreal

This property holds the base of the logarithm.

The value has to be greater than 0 and cannot equal 1.

Access functions:

qreal | base() const
void | setBase(qreal base)

Notifier signal:

void | baseChanged(qreal base)

### labelFormat : QString

This property holds the label format of the axis.

The format string supports the following conversion specifiers, length modifiers, and flags provided by `printf()` in the standard C++ library: d, i, o, x, X, f, F, e, E, g, G, c.

If QChart::localizeNumbers is `true`, the supported specifiers are limited to: d, e, E, f, g, G, and i. Also, only the precision modifier is supported. The rest of the formatting comes from the default QLocale of the application.

Access functions:

QString | labelFormat() const
void | setLabelFormat(const QString &format)

Notifier signal:

void | labelFormatChanged(const QString &format)

See also QString::asprintf().

### max : qreal

This property holds the maximum value on the axis.

When setting this property, the minimum value is adjusted if necessary, to ensure that the range remains valid. The value has to be greater than 0.

Access functions:

qreal | max() const
void | setMax(qreal max)

Notifier signal:

void | maxChanged(qreal max)

### min : qreal

This property holds the minimum value on the axis.

When setting this property, the maximum value is adjusted if necessary, to ensure that the range remains valid. The value has to be greater than 0.

Access functions:

qreal | min() const
void | setMin(qreal min)

Notifier signal:

void | minChanged(qreal min)

## Member Function Documentation

### QLogValueAxis::QLogValueAxis(QObject *parent = Q_NULLPTR)

Constructs an axis object that is a child of parent.

### QLogValueAxis::~QLogValueAxis()

Destroys the object.

### `[signal]` void QLogValueAxis::baseChanged(qreal base)

This signal is emitted when the base of the logarithm of the axis changes.

Note: Notifier signal for property base.

### `[signal]` void QLogValueAxis::labelFormatChanged(const QString &format)

This signal is emitted when the format of axis labels changes.

Note: Notifier signal for property labelFormat.

### `[signal]` void QLogValueAxis::maxChanged(qreal max)

This signal is emitted when the maximum value of the axis, specified by max, changes.

Note: Notifier signal for property max.

### `[signal]` void QLogValueAxis::minChanged(qreal min)

This signal is emitted when the minimum value of the axis, specified by min, changes.

Note: Notifier signal for property min.

### `[signal]` void QLogValueAxis::rangeChanged(qreal min, qreal max)

This signal is emitted when the minimum or maximum value of the axis, specified by min and max, changes.

### void QLogValueAxis::setRange(qreal min, qreal max)

Sets the range from min to max on the axis. If min is greater than max, this function returns without making any changes.

### `[virtual]` AxisType QLogValueAxis::type() const

Reimplemented from QAbstractAxis::type().

Returns the type of the axis.