QValue3DAxis Class
QValue3DAxis 类用于操作图形的坐标轴。更多
| 头文件： | #include <QValue3DAxis> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS Graphs)target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake： | QT += graphs |
| 在 QML 中： | Value3DAxis |
| 继承： | QAbstract3DAxis |
- 所有成员的列表，包括继承成员
- QValue3DAxis 是Qt Graphs C++ Classes for 3D 的一部分。
属性
|
|
公共功能
| QValue3DAxis(QObject *parent = nullptr) | |
| virtual | ~QValue3DAxis() override |
| QValue3DAxisFormatter * | formatter() const |
| QString | labelFormat() const |
| bool | reversed() const |
| qsizetype | segmentCount() const |
| void | setFormatter(QValue3DAxisFormatter *formatter) |
| void | setLabelFormat(const QString &format) |
| void | setReversed(bool enable) |
| void | setSegmentCount(qsizetype count) |
| void | setSubSegmentCount(qsizetype count) |
| qsizetype | subSegmentCount() const |
信号
| void | formatterChanged(QValue3DAxisFormatter *formatter) |
| void | labelFormatChanged(const QString &format) |
| void | reversedChanged(bool enable) |
| void | segmentCountChanged(qsizetype count) |
| void | subSegmentCountChanged(qsizetype count) |
详细说明
值轴可以给定一个数值范围，以及划分该范围的段和子段计数。
每个分段之间会绘制标签，每个分段和每个子分段之间会绘制网格线。
注： 如果可见，则总是至少有两条网格线和标签指示范围的最小值和最大值，因为总是至少有一个分段。
属性文档
formatter : QValue3DAxisFormatter*
该属性用于保存要使用的轴格式。
设置新格式后，现有格式将被删除。
访问功能：
| QValue3DAxisFormatter * | formatter() const |
| void | setFormatter(QValue3DAxisFormatter *formatter) |
通知信号：
| void | formatterChanged(QValue3DAxisFormatter *formatter) |
labelFormat : QString
此属性用于保存此坐标轴上的标签格式。
格式字符串支持printf() 在标准 C++ 库中提供的以下转换指定符、长度修饰符和标志：d、i、o、x、X、f、F、e、E、g、G、c。
如果Q3DGraphsWidgetItem::locale 不是"C" ，则支持的指定符仅限于：d、e、E、f、g、G 和 i。此外，只支持精度修饰符。其余格式来自应用程序的默认QLocale 。
使用示例
axis->setLabelFormat("%.2f mm");
访问功能：
| QString | labelFormat() const |
| void | setLabelFormat(const QString &format) |
Notifier 信号：
| void | labelFormatChanged(const QString &format) |
另请参阅 formatter 和Q3DGraphsWidgetItem::locale 。
reversed : bool
该属性用于确定是否反向渲染坐标轴。
如果true ，坐标轴将反向渲染，这意味着在渲染图形时，最小值和最大值的位置将互换。此属性不会影响坐标轴的实际最小值和最大值。
访问功能：
| bool | reversed() const |
| void | setReversed(bool enable) |
通知信号：
| void | reversedChanged(bool enable) |
segmentCount : qsizetype
该属性用于保存坐标轴上的线段数。
这表示要绘制多少个标签。要绘制的网格线数量用公式计算：segments * subsegments + 1.预设默认值为5 。该值不能低于1 。
访问功能：
| qsizetype | segmentCount() const |
| void | setSegmentCount(qsizetype count) |
通知信号：
| void | segmentCountChanged(qsizetype count) |
另请参阅 setSubSegmentCount() 。
subSegmentCount : qsizetype
此属性表示轴上每个线段内部的子线段数。
除每个线段外，每个子线段之间也会绘制网格线。预设默认值为1 。该值不能低于1 。
访问功能：
| qsizetype | subSegmentCount() const |
| void | setSubSegmentCount(qsizetype count) |
通知信号：
| void | subSegmentCountChanged(qsizetype count) |
另请参见 setSegmentCount().
成员函数文档
[explicit] QValue3DAxis::QValue3DAxis(QObject *parent = nullptr)
用给定的parent 构造 QValue3DAxis。
[override virtual noexcept] QValue3DAxis::~QValue3DAxis()
销毁QValue3DAxis 。
© 2025 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.
