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 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() を呼び出すと、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()

タイムラインの方向を切り替える。順方向だった場合は逆方向となり、逆方向の場合は逆方向となる。

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