Back to Qt.io
Contact Us Blog Download Qt

QDateTimeAxis Class

QDateTimeAxis クラスは、チャートの軸に日付と時刻を追加します。詳細...

Header: #include <QDateTimeAxis>
In QML: DateTimeAxis
Inherits: QAbstractAxis

プロパティ

パブリック関数

QDateTimeAxis(QObject *parent = nullptr)
virtual ~QDateTimeAxis()
QString format() const
QDateTime max() const
QDateTime min() const
void setFormat(QString format)
void setMax(QDateTime max)
void setMin(QDateTime min)
void setRange(QDateTime min, QDateTime max)
void setTickCount(int count)
int tickCount() const

再実装パブリック関数

virtual QAbstractAxis::AxisType type() const override

シグナル

void formatChanged(QString format)
void maxChanged(QDateTime max)
void minChanged(QDateTime min)
void rangeChanged(QDateTime min, QDateTime max)
void tickCountChanged(int tickCount)

詳細説明

QDateTimeAxis は、目盛り、グリッド線、および陰影を持つ軸線を表示するように設定できます。ラベルは、適切な DateTime 形式を設定することで構成できます。QDateTimeAxis は、紀元前 4714 年から西暦 287396 年までの日付で正しく機能します。QDateTime に関連するその他の制限については、QDateTime のドキュメントを参照してください。

注意: QDateTimeAxis は、qreal を float として定義しているプラットフォームでは使用できません。

QDateTimeAxis は、任意のQXYSeries で使用できます。データ・ポイントを系列に追加するには、QDateTime::toMSecsSinceEpoch() を使用します：

QLineSeries *series = new QLineSeries;

QDateTime xValue;
xValue.setDate(QDate(2012, 1 , 18));
xValue.setTime(QTime(9, 34));
qreal yValue = 12;
series->append(xValue.toMSecsSinceEpoch(), yValue);

xValue.setDate(QDate(2013, 5 , 11));
xValue.setTime(QTime(11, 14));
qreal yValue = 22;
series->append(xValue.toMSecsSinceEpoch(), yValue);

次のコード・スニペットは、チャートへの系列の追加と QDateTimeAxis の設定を示しています：

QChartView *chartView = new QChartView;
chartView->chart()->addSeries(series);

// ...
QDateTimeAxis *axisX = new QDateTimeAxis;
axisX->setFormat("dd-MM-yyyy h:mm");
chartView->chart()->setAxisX(axisX, series);

プロパティ・ドキュメンテーション

format : QString

このプロパティは、QDateTime オブジェクトから軸のラベルを作成するときに使用されるフォーマット文字列を保持する。

文字列の定義方法については、QDateTime のドキュメントを参照してください。

アクセス関数：

QString format() const
void setFormat(QString format)

ノーティファイアシグナル：

void formatChanged(QString format)

QChart::localeも参照してください 。

max : QDateTime

このプロパティは、軸の最大値を保持する。

このプロパティを設定するときは、範囲が有効であることを保証するために、必要に応じて最小値が調整される。

アクセス関数

QDateTime max() const
void setMax(QDateTime max)

ノーティファイア信号：

void maxChanged(QDateTime max)

min : QDateTime

このプロパティは、軸の最小値を保持する。

このプロパティを設定すると、必要に応じて最大値が調整され、範囲が有効であることを保証する。

アクセス関数

QDateTime min() const
void setMin(QDateTime min)

ノーティファイア信号：

void minChanged(QDateTime min)

tickCount : int

このプロパティは、軸上の目盛りの数を保持する。

アクセス関数：

int tickCount() const
void setTickCount(int count)

通知シグナル：

void tickCountChanged(int tickCount)

メンバ関数ドキュメント

[explicit] QDateTimeAxis::QDateTimeAxis(QObject *parent = nullptr)

parent の子である軸オブジェクトを構築する。

[virtual noexcept] QDateTimeAxis::~QDateTimeAxis()

オブジェクトを破壊する。

[signal] void QDateTimeAxis::formatChanged(QString format)

このシグナルは、軸のformat が変化したときに発せられる。

注意: format プロパティのノーティファイアシグナル。

[signal] void QDateTimeAxis::maxChanged(QDateTime max)

このシグナルは、max で指定された軸の最大値が変更されたときに発行される。

注： max プロパティのノーティファイアシグナル。

[signal] void QDateTimeAxis::minChanged(QDateTime min)

このシグナルは、min で指定された軸の最小値が変更されたときに発行される。

注： min プロパティのノーティファイアシグナル。

[signal] void QDateTimeAxis::rangeChanged(QDateTime min, QDateTime max)

このシグナルは、min とmax で指定される軸の最小値または最大値が変化したときに発せられる。

void QDateTimeAxis::setRange(QDateTime min, QDateTime max)

軸の範囲をmin からmax まで設定する。min がmax より大きい場合、この関数は何も変更せずに戻る。

void QDateTimeAxis::setTickCount(int count)

軸の目盛りの数をcount に設定します。

注意: プロパティのセッター関数tickCount 。

tickCount()も参照してください 。

int QDateTimeAxis::tickCount() const

軸上の目盛りの数を返します。

注釈: プロパティ tickCount のゲッター関数。

setTickCount()も参照してください 。

[signal] void QDateTimeAxis::tickCountChanged(int tickCount)

このシグナルは、tickCount で指定された軸の目盛りの数が変更されたときに発行される。

注: プロパティtickCount に対するノーティファイア・シグナル。

[override virtual] QAbstractAxis::AxisType QDateTimeAxis::type() const

再実装：QAbstractAxis::type() const.

軸の型を返します。

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