Back to Doc.qt.io
Contact Us Blog Download Qt

Category3DAxis QML Type

Manipulates an axis of a graph. More...

Import Statement: import QtGraphs
In C++: QCategory3DAxis
Inherits:

Abstract3DAxis

Properties

Signals

Detailed Description

This type provides an axis that can be given labels.

Property Documentation

autoAdjustRange : bool

Defines whether the axis will automatically adjust the range so that all data fits in it.


labelAutoAngle : real

The maximum angle the labels can autorotate when the camera angle changes. The angle can be between 0 and 90, inclusive. The default value is 0. If the value is 0, axis labels do not automatically rotate. If the value is greater than zero, labels attempt to orient themselves toward the camera, up to the specified angle.


labelSize : real [since 6.9]

The size of the label. The default for this value is 1.0.

This property was introduced in Qt 6.9.

See also scaleLabelsByCount.


labels : list

The labels for the axis are applied to categories. If there are fewer labels than categories, the remaining ones do not have a label. If category labels are not defined explicitly, labels are generated from the data row (or column) labels of the primary series of the graph.


labelsVisible : bool

Defines whether the axis labels are visible in the primary graph view.

The default value is true.


max : real

The maximum value on the axis. When setting this property, the minimum value is adjusted if necessary, so the range remains valid.


min : real

The minimum value on the axis. When setting this property, the maximum value is adjusted if necessary, so the range remains valid.


orientation : Abstract3DAxis.AxisOrientation [read-only]

The orientation of the axis.


scaleLabelsByCount : bool [since 6.9]

Whether the labels will automatically adjust their size based on the total amount of labels.

This property was introduced in Qt 6.9.

See also labelSize.


title : string

The title for the axis.

See also titleVisible and titleFixed.


titleFixed : bool

The rotation of axis titles.

If false, axis titles in the primary graph view will be rotated towards the camera similarly to the axis labels. If true, axis titles are only rotated around their axis but are not otherwise oriented towards the camera. This property does not have any effect if the labelAutoAngle property value is zero. Default value is true.

See also labelAutoAngle, title, and titleVisible.


titleOffset : real

The position of the axis title on the axis. The value must be between -1.0f and 1.0f

Default value is 0.

See also title and titleVisible.


titleVisible : bool

Defines whether the axis title is visible in the primary graph view.

The default value is false.

See also title and titleFixed.


type : Abstract3DAxis.AxisType [read-only]

The type of the axis.


Signal Documentation

autoAdjustRangeChanged(bool autoAdjust)

This signal is emitted when the autoAdjustRange property value changes to autoAdjust.

Note: The corresponding handler is onAutoAdjustRangeChanged.


columnLabelsChanged()

* * * This signal is emitted when column labels change.

Note: The corresponding handler is onColumnLabelsChanged.


labelAutoAngleChanged(real angle)

This signal is emitted when the angle of label rotation changes to angle.

Note: The corresponding handler is onLabelAutoAngleChanged.


labelSizeChanged(real size)

This signal is emitted when the labelSize property value changes to size.

Note: The corresponding handler is onLabelSizeChanged.


labelVisibilityChanged(bool visible)

This signal is emitted when the label visibility changes to visible.

Note: The corresponding handler is onLabelVisibilityChanged.


labelsChanged()

This signal is emitted when axis labels change.

Note: The corresponding handler is onLabelsChanged.


maxChanged(real value)

This signal is emitted when the maximum value of the axis changes to value.

Note: The corresponding handler is onMaxChanged.


minChanged(real value)

This signal is emitted when the minimum value of the axis changes to value.

Note: The corresponding handler is onMinChanged.


orientationChanged(AxisOrientation orientation)

This signal is emitted when axis orientation changes to orientation.

Note: The corresponding handler is onOrientationChanged.


rangeChanged(real min, real max)

This signal is emitted when the axis range changes. min and max are the min and max of the new range.

Note: The corresponding handler is onRangeChanged.


rowLabelsChanged()

* * * This signal is emitted when row labels change.

Note: The corresponding handler is onRowLabelsChanged.


scaleLabelsByCountChanged(bool adjust)

This signal is emitted when the scaleLabelsByCount property value changes to adjust.

Note: The corresponding handler is onScaleLabelsByCountChanged.


titleChanged(string newTitle)

This signal is emitted when title changes to newTitle.

Note: The corresponding handler is onTitleChanged.


titleFixedChanged(bool fixed)

This signal is emitted when the titleFixed property value changes to fixed.

Note: The corresponding handler is onTitleFixedChanged.


titleOffsetChanged(real offset)

This signal is emitted when the titleOffset property value changes to offset.

Note: The corresponding handler is onTitleOffsetChanged.


titleVisibilityChanged(bool visible)

This signal is emitted when the title visibility changes to visible.

Note: The corresponding handler is onTitleVisibilityChanged.


© 2024 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.