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.

軸のタイプを返します。

本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。