QDateTimeAxis Class
QDateTimeAxis クラスは、チャートの軸に日付と時刻を追加します。詳細...
| Header: | #include <QDateTimeAxis> |
| In QML: | DateTimeAxis |
| Inherits: | QAbstractAxis |
| Status: | Deprecated |
このクラスは非推奨です。新しいコードでの使用は強く推奨しません。
プロパティ
パブリック関数
| 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 のドキュメントを参照してください。
注： qreal が float として定義されているプラットフォームでは、QDateTimeAxis は 無効になります。
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。
軸の型を返します。
© 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.
