QTimeLine Class

...
progressBar = new QProgressBar(this);
progressBar->setRange(0, 100);

// Construct a 1-second timeline with a frame range of 0 - 100
QTimeLine *timeLine = new QTimeLine(1000, this);
timeLine->setFrameRange(0, 100);
connect(timeLine, &QTimeLine::frameChanged, progressBar, &QProgressBar::setValue);

// Clicking the push button will start the progress bar animation
pushButton = new QPushButton(tr("Start animation"), this);
connect(pushButton, &QPushButton::clicked, timeLine, &QTimeLine::start);
...

メンバー関数ドキュメント

[explicit] QTimeLine::QTimeLine(int duration = 1000, QObject *parent = nullptr)

duration parent は のコンストラクタに渡される。デフォルトの継続時間は1000ミリ秒である。QObject

[virtual noexcept] QTimeLine::~QTimeLine()

タイムラインを破棄します。

int QTimeLine::currentFrame() const

現在の時刻に対応するフレームを返します。

currentTime()、frameForTime()、setFrameRange()も参照 。

qreal QTimeLine::currentValue() const

現在時刻に対応する値を返します。

valueForTime() およびcurrentFrame() も参照して ください。

int QTimeLine::endFrame() const

エンドフレームを返します。これは、タイムラインの最後に対応するフレーム（つまり、現在の値が 1 であるフレーム）です。

setEndFrame() およびsetFrameRange()も参照 。

[private signal] void QTimeLine::finished()

このシグナルは、QTimeLine が終了する（つまり時間軸の最後に到達する）ときに発せられ、ループはしない。

[private signal] void QTimeLine::frameChanged(int frame)

QTimeLine frame は現在のフレーム番号です。 状態のとき、一定間隔でこのシグナルを発しますが、現在のフレームが変化した場合のみです。Running

QTimeLine::setFrameRange() およびQTimeLine::updateIntervalも参照のこと 。

int QTimeLine::frameForTime(int msec) const

時刻msec に対応するフレームを返します。この値は、valueForTime() が返す値に基づいて、開始フレームと終了フレームの線形補間を使用して計算されます。

valueForTime() およびsetFrameRange()も参照 。

[slot] void QTimeLine::resume()

QTimeLine は再び Running 状態に入り、イベントループに入ると、一定間隔で現在時刻、フレーム、値を更新します。

start() とは対照的に、この関数は再開前にタイムラインを再開しません。

start()、updateInterval()、frameChanged()、valueChanged()も参照 。

void QTimeLine::setEndFrame(int frame)

タイムラインの最後に相当するフレーム（すなわち、現在の値が 1 であるフレーム）である終了フレームをframe に設定します。

endFrame()、startFrame()、setFrameRange()も参照 。

void QTimeLine::setFrameRange(int startFrame, int endFrame)

タイムラインのフレーム・カウンターを、startFrame から開始し、endFrame で終了するように設定します。currentFrame() またはframeForTime() を呼び出すと、valueForTime() の戻り値を使用して補間することにより、各時間値についてQTimeLine が対応するフレームを見つけます。

Running 状態のとき、QTimeLine は、フレームが変化するとframeChanged() シグナルも発する。

startFrame(),endFrame(),start(),currentFrame()も参照 。

[slot] void QTimeLine::setPaused(bool paused)

paused が true の場合、タイムラインは一時停止され、QTimeLine が Paused 状態になります。start() またはsetPaused(false)が呼び出されるまで、更新は通知されない。paused がfalseの場合、タイムラインは再開され、元の状態に戻ります。

state() およびstart()も参照してください 。

void QTimeLine::setStartFrame(int frame)

タイムラインの開始フレーム（すなわち、現在値が 0 であるフレーム）をframe に設定します。

startFrame()、endFrame()、setFrameRange()も参照 。

[slot] void QTimeLine::start()

タイムラインを開始します。QTimeLine は Running 状態に入り、イベントループに入ると、一定間隔で現在時刻、フレーム、値を更新します。デフォルトの更新間隔は40ミリ秒（1秒間に25回）です。更新間隔は、setUpdateInterval （）を呼び出すことで変更できます。

タイムラインは0位置からスタートします。停止したタイムラインを再開せずに再開したい場合は、代わりにresume() を呼び出すことができる。

resume()、updateInterval()、frameChanged()、valueChanged()も参照 。

int QTimeLine::startFrame() const

開始フレームを返します。これは、タイムラインの開始フレーム（つまり、現在値が 0 であるフレーム）に対応します。

setStartFrame() およびsetFrameRange()も参照してください 。

QTimeLine::State QTimeLine::state() const

タイムラインの状態を返します。

start （）、setPaused （）、stop （）も参照 。

[private signal] void QTimeLine::stateChanged(QTimeLine::State newState)

このシグナルは、QTimeLine の状態が変化するたびに発せられる。新しい状態はnewState 。

[slot] void QTimeLine::stop()

タイムラインを停止し、QTimeLine をNotRunning の状態にする。

start()も参照 。

[override virtual protected] void QTimeLine::timerEvent(QTimerEvent *event)

再実装：QObject::timerEvent(QTimerEvent *event)。

[slot] void QTimeLine::toggleDirection()

タイムラインの方向を切り替えます。方向が Forward だった場合、Backward になります。

direction の既存のバインディングは削除されます。

setDirection()も参照 。

[private signal] void QTimeLine::valueChanged(qreal value)

QTimeLine Running 状態のとき、一定間隔でこのシグナルを発しますが、現在の値が変化した場合のみ、このシグナルを発します。 は現在の値です。 は0.0から1.0の間の数値です。value value

QTimeLine::setDuration()、QTimeLine::valueForTime()、QTimeLine::updateIntervalも参照 。

[virtual] qreal QTimeLine::valueForTime(int msec) const

時刻のタイムライン値を返すmsec 。返される値は、曲線の形状によって異なりますが、常に 0 から 1 の間です。msec が 0 の場合、デフォルトの実装では常に 0 が返されます。

この関数を再実装して、タイムラインのカスタム曲線形状を提供してください。

easingCurve とframeForTime()も参照してください 。