QTimeLine Class

//...
auto 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
auto 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 は、QObject のコンストラクタに渡されます。デフォルトの持続時間は1000ミリ秒です。

[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 Running 状態のときは、現在のフレームが変更された場合に限り、このシグナルを一定間隔で発信します。 は現在のフレーム番号です。frame

関連項目： 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()を呼び出すと、QTimeLine はvalueForTime()の戻り値を用いて補間を行い、対応するフレームを特定します。

「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()

タイムラインの方向を切り替えます。「前方」だった場合は「後方」になり、その逆も同様です。

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()も参照してください 。