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 은 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 이벤트 루프에 들어가면 현재 시간, 프레임 및 값을 일정한 간격으로 업데이트합니다.

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 에서 해당 프레임을 찾습니다.

실행 중 상태일 때 QTimeLine 는 프레임이 변경되면 frameChanged() 신호도 전송합니다.

startFrame(), endFrame(), start() 및 currentFrame()도 참조하세요 .

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

paused 이 참이면 타임라인이 일시 중지되어 QTimeLine 이 일시 중지 상태가 됩니다. start () 또는 setPaused(false)가 호출될 때까지 업데이트 알림이 표시되지 않습니다. paused 가 false이면 타임라인이 재개되어 중단된 지점부터 계속됩니다.

state() 및 start()도 참조하세요 .

void QTimeLine::setStartFrame(int frame)

타임라인의 시작에 해당하는 프레임(즉, 현재 값이 0인 프레임)인 시작 프레임을 frame 으로 설정합니다.

startFrame(), endFrame() 및 setFrameRange()도 참조하세요 .

[slot] void QTimeLine::start()

QTimeLine 은 실행 중 상태가 되고 이벤트 루프에 들어가면 현재 시간, 프레임 및 값을 일정한 간격으로 업데이트합니다. 기본 간격은 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(Q타이머이벤트 *이벤트).

[slot] void QTimeLine::toggleDirection()

타임라인의 방향을 전환합니다. 방향이 앞으로인 경우 뒤로가 되고, 그 반대의 경우도 마찬가지입니다.

direction 의 기존 바인딩은 제거됩니다.

setDirection()도 참조하세요 .

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

QTimeLine 는 Running 상태일 때 일정한 간격으로 이 신호를 보내지만 현재 값이 변경된 경우에만 이 신호를 보냅니다. value 은 현재 값입니다. value 은 0.0에서 1.0 사이의 숫자입니다.

QTimeLine::setDuration(), QTimeLine::valueForTime() 및 QTimeLine::updateInterval 를참조하세요 .

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

msec 에 대한 타임라인 값을 반환합니다. 반환되는 값은 커브 모양에 따라 다르며 항상 0에서 1 사이입니다. msec 이 0이면 기본 구현은 항상 0을 반환합니다.

타임라인에 사용자 지정 커브 모양을 제공하려면 이 함수를 다시 구현하세요.

easingCurve 및 frameForTime()도 참조하세요 .