本页内容

QDateTimeAxis Class

QDateTimeAxis 支持将 DateTime 值添加到图表的坐标轴上。更多内容...

头文件: #include <QDateTimeAxis>
CMake: find_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake: QT += graphs
在 QML 中: DateTimeAxis
继承自: QAbstractAxis

属性

公共函数

QString labelFormat() const
QDateTime max() const
QDateTime min() const
qreal pan() const
void setLabelFormat(const QString &format)
void setMax(const QDateTime &max)
void setMin(const QDateTime &min)
void setPan(qreal pan)
void setSubTickCount(int newSubTickCount)
void setTickCount(qsizetype count)
void setTickInterval(qreal newTickInterval)
void setTimeZone(const QTimeZone &zoneId)
void setZoom(qreal zoom)
int subTickCount() const
qsizetype tickCount() const
qreal tickInterval() const
QTimeZone timeZone() const
QDateTime visualMax() const
QDateTime visualMin() const
qreal zoom() const

信号

void labelFormatChanged(const QString &format)
void maxChanged(const QDateTime &max)
void minChanged(const QDateTime &min)
void panChanged(qreal newPan)
void subTickCountChanged()
void tickCountChanged(qsizetype count)
void tickIntervalChanged()
void timeZoneChanged(const QTimeZone &newTimeZone)
void visualMaxChanged(const QDateTime &newMax)
void visualMinChanged(const QDateTime &newMin)
void zoomChanged(qreal newZoom)

详细说明

DateTime 轴可用于显示带有刻度和网格线的 DateTime 表示形式。轴上的 DateTime 项目显示在刻度位置处。

属性文档

labelFormat : QString

该属性用于指定轴上 DateTime 标签的格式。format 属性可用于定义 DateTime 对象在天、月和年层面的视觉显示形式。默认值为 dd-MMMM-yy。

访问函数:

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

通知信号:

void labelFormatChanged(const QString &format)

max : QDateTime

该属性表示轴上的最大值

该值可能小于或大于最小值。DateTime 类型在内部以 UTC 格式存储。默认值为 new Date(1980,1,1)

访问函数:

QDateTime max() const
void setMax(const QDateTime &max)

通知器信号:

void maxChanged(const QDateTime &max)

min : QDateTime

该属性表示轴上的最小值

该值可能小于或大于最大值。DateTime 类型在内部以 UTC 格式存储。默认值为 new Date(1970,1,1)

访问函数:

QDateTime min() const
void setMin(const QDateTime &min)

通知信号:

void minChanged(const QDateTime &min)

[since 6.11] pan : qreal

该属性存储坐标轴的平移值。

平移值可移动坐标轴的中心,同时不影响网格和标签的间隔。默认值为 0。

该枚举在 Qt 6.11 中引入。

访问函数:

qreal pan() const
void setPan(qreal pan)

通知器信号:

void panChanged(qreal newPan)

subTickCount : int

该属性存储轴上的子刻度数量。这表示图表中主刻度线之间绘制了多少个子刻度。子刻度不显示标签。默认值为 0。

访问函数:

int subTickCount() const
void setSubTickCount(int newSubTickCount)

通知信号:

void subTickCountChanged()

[since 6.12] tickCount : qsizetype

该属性用于指定轴上主要刻度的数量。如果该值为 0 或更小,轴将自动计算适当的刻度数量。默认值为 0。

该枚举类型在 Qt 6.12 中引入。

访问函数:

qsizetype tickCount() const
void setTickCount(qsizetype count)

通知器信号:

void tickCountChanged(qsizetype count)

[until 6.15] tickInterval : qreal

该枚举计划在 6.15 版本中被废弃。

该属性用于指定轴上放置的主要刻度数量。如果值为 0 或更小,轴将自动计算适当的刻度数量。默认值为 0。请改用 `tickCount `。

访问函数:

qreal tickInterval() const
void setTickInterval(qreal newTickInterval)

通知信号:

void tickIntervalChanged()

[since 6.11] timeZone : QTimeZone

该属性用于存储显示轴标签时所使用的时区。支持的值基于 IANA 时区标识符。默认时区为 UTC。

该枚举类型自 Qt 6.11 起引入。

访问函数:

QTimeZone timeZone() const
void setTimeZone(const QTimeZone &zoneId)

通知器信号:

void timeZoneChanged(const QTimeZone &newTimeZone)

[read-only, since 6.11] visualMax : QDateTime

该属性保存了坐标轴的视觉最大值。

当轴被平移或缩放时,该属性保存轴的视觉最大值。默认值为QDateTimeAxis::max

该枚举在 Qt 6.11 中引入。

访问函数:

QDateTime visualMax() const

通知器信号:

void visualMaxChanged(const QDateTime &newMax)

[read-only, since 6.11] visualMin : QDateTime

该属性保存了轴的视觉最小值。

当轴被平移或缩放时,该属性保存轴的视觉最小值。默认值为QDateTimeAxis::min

该枚举在 Qt 6.11 中引入。

访问函数:

QDateTime visualMin() const

通知器信号:

void visualMinChanged(const QDateTime &newMin)

[since 6.11] zoom : qreal

该属性存储轴的缩放值。缩放值可放大或缩小轴(从而放大或缩小图表),同时不会影响网格间隔和标签。默认值为 1。

该枚举类型在 Qt 6.11 中引入。

访问函数:

qreal zoom() const
void setZoom(qreal zoom)

通知器信号:

void zoomChanged(qreal newZoom)

© 2026 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.