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 에서 끝날 수 있도록 설정합니다. 각 시간 값에 대해, QTimeLine 는 currentFrame() 또는 frameForTime()을 호출할 때 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)’ 상태로 전환되며, 이벤트 루프에 진입하면 일정한 간격으로 현재 시간, 프레임 및 값을 업데이트합니다. 기본 간격은 40ms(즉, 초당 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()도 참조하십시오 .