QTimer Class

멤버 함수 설명서

[explicit] QTimer::QTimer(QObject *parent = nullptr)

지정된 ` parent`를 사용하여 타이머를 생성합니다.

[virtual noexcept] QTimer::~QTimer()

타이머를 제거합니다.

template <typename Functor> QMetaObject::Connection QTimer::callOnTimeout(Functor &&slot)

타이머의 ` timeout()` 신호와 ` slot` 간에 연결을 생성합니다. 연결에 대한 핸들을 반환합니다.

이 메서드는 편의상 제공됩니다. 다음 호출과 동일합니다:

QObject::connect(timer, &QTimer::timeout, timer, slot, Qt::DirectConnection);

QObject::connect() 및 timeout()도 참조하십시오 .

template <typename Functor> QMetaObject::Connection QTimer::callOnTimeout(const QObject *context, Functor &&slot, Qt::ConnectionType connectionType = Qt::AutoConnection)

timeout() 신호에서 slot 으로 연결을 생성하여 context 의 특정 이벤트 루프에 배치하고, 해당 연결에 대한 핸들을 반환합니다.

이 메서드는 편의상 제공됩니다. 다음 호출과 동일합니다:

QObject::connect(timer, &QTimer::timeout, context, slot, connectionType);

QObject::connect() 및 timeout()도 참조하십시오 .

[since 6.8] Qt::TimerId QTimer::id() const

타이머가 실행 중일 경우 타이머 ID를 나타내는 ` Qt::TimerId `를 반환하고, 그렇지 않은 경우 ` Qt::TimerId::Invalid`를 반환합니다.

이 함수는 Qt 6.8에서 도입되었습니다.

Qt::TimerId도 참조하십시오 .

std::chrono::milliseconds QTimer::intervalAsDuration() const

이 타이머의 간격을 ` std::chrono::milliseconds ` 객체로 반환합니다.

interval도 참조하십시오 .

bool QTimer::isActive() const

타이머가 실행 중이면 ` true `를 반환하고, 그렇지 않으면 ` false`를 반환합니다.

std::chrono::milliseconds QTimer::remainingTimeAsDuration() const

이 타이머 객체의 남은 시간을 ` std::chrono::milliseconds ` 객체로 반환합니다. 이 타이머가 만료되었거나 만료 시간이 지난 경우, 반환 값은 ` std::chrono::milliseconds::zero()`입니다. 남은 시간을 찾을 수 없거나 타이머가 실행 중이 아닌 경우, 이 함수는 음수의 지속 시간을 반환합니다.

remainingTime()도 참조하십시오 .

이 정적 함수는 ` interval` 실행 후 ` functor `을 호출합니다.

이 함수를 사용하면 ` timerEvent `을 직접 처리하거나 ` QTimer ` 객체를 로컬로 생성할 필요가 없으므로 매우 편리합니다.

context 가 지정된 경우, functor 는 context 객체가 인터벌이 발생하기 전에 소멸되지 않은 경우에만 호출됩니다. 그러면 펑크터는 context 의 스레드에서 실행됩니다. 컨텍스트의 스레드에는 실행 중인 Qt 이벤트 루프가 있어야 합니다.

functor 가 context 의 멤버 함수인 경우, 해당 함수는 객체에서 호출됩니다.

interval 매개변수는 int (밀리초 수로 해석됨)이거나, 암시적으로 나노초로 변환되는 std::chrono 유형일 수 있습니다.

Qt 6.10부터는 음수의 간격을 설정하면 런타임 경고가 발생하고 값이 1ms로 재설정됩니다. Qt 6.10 이전 버전에서는 Qt Timer에서 음수 간격을 설정할 수 있었지만, 예상치 못한 방식으로 동작했습니다(예를 들어, 타이머가 실행 중이면 중지되거나 아예 시작되지 않는 경우 등).

참고: 이 함수는 재진입 가능합니다.

start()도 참조하십시오 .

[static] void QTimer::singleShot(std::chrono::nanoseconds nsec, const QObject *receiver, const char *member)

이 정적 함수는 지정된 시간 간격이 지난 후 슬롯을 호출합니다.

이 함수를 사용하면 ` timerEvent `을 신경 쓸 필요도 없고, ` QTimer ` 객체를 로컬로 생성할 필요도 없기 때문에 매우 편리합니다.

receiver 는 수신 객체이며, member 는 슬롯입니다. 시간 간격은 지속 시간 객체 nsec 로 지정됩니다.

Qt 6.10부터는 음수의 간격을 설정하면 런타임 경고가 발생하고 값이 1ms로 재설정됩니다. Qt 6.10 이전 버전에서는 Qt Timer에서 음수 간격을 설정할 수 있었지만, 예상치 못한 방식으로 동작했습니다(예를 들어, 타이머가 실행 중이면 중지되거나 아예 시작되지 않는 경우 등).

참고: 이 함수는 재진입 가능합니다.

start()도 참조하십시오 .

[static] void QTimer::singleShot(std::chrono::nanoseconds nsec, Qt::TimerType timerType, const QObject *receiver, const char *member)

이 정적 함수는 지정된 시간 간격이 지난 후 슬롯을 호출합니다.

이 함수를 사용하면 ‘ timerEvent ’을 신경 쓸 필요도 없고, 로컬 ‘ QTimer ’ 객체를 생성할 필요도 없기 때문에 매우 편리합니다.

receiver 는 수신 객체이고, member 는 슬롯입니다. 시간 간격은 duration 객체 nsec 로 지정됩니다. timerType 는 타이머의 정확도에 영향을 미칩니다.

Qt 6.10부터는 음수의 간격을 설정하면 런타임 경고가 발생하며, 해당 값은 1ms로 재설정됩니다. Qt 6.10 이전 버전에서는 Qt Timer에서 음수 간격을 설정할 수 있었으나, 예상치 못한 동작을 보였습니다(예: 실행 중인 타이머가 중지되거나 아예 시작되지 않는 경우 등).

참고: 이 함수는 재진입 가능합니다.

start()도 참조하십시오 .

[slot] void QTimer::start(int msec)

msec 밀리초의 타임아웃 간격으로 타이머를 시작하거나 다시 시작합니다.

이는 다음 코드와 동일합니다:

timer.setInterval(msec);
timer.start();

타이머가 이미 실행 중이라면, stopped 후 다시 시작됩니다. 이 경우 타이머의 id() 값도 변경됩니다.

singleShot 가 true인 경우, 타이머는 한 번만 활성화됩니다.

Qt 6.10부터는 음수의 간격을 설정하면 런타임 경고가 발생하고 값이 1ms로 재설정됩니다. Qt 6.10 이전에는 Qt Timer에서 음수 간격을 설정할 수 있었지만, 예상치 못한 방식으로 동작했습니다(예를 들어, 타이머가 실행 중이면 중지되거나 아예 시작되지 않는 등).

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        timer, qOverload(&QTimer::start));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        timer, [receiver = timer](int msec) { receiver->start(msec); });

[slot] void QTimer::start()

interval 에 지정된 타임아웃을 사용하여 타이머를 시작하거나 다시 시작합니다.

타이머가 이미 실행 중인 경우, ` stopped `로 설정된 후 다시 시작됩니다. 이 경우 타이머의 ` id()` 값도 변경됩니다.

singleShot 가 true인 경우, 타이머는 한 번만 활성화됩니다.

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        timer, qOverload<>(&QTimer::start));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        timer, [receiver = timer]() { receiver->start(); });

void QTimer::start(std::chrono::milliseconds interval)

interval 밀리초의 타임아웃을 설정하여 타이머를 시작하거나 다시 시작합니다.

이는 다음 코드와 동일합니다:

timer.setInterval(interval);
timer.start();

타이머가 이미 실행 중이라면, stopped 상태로 재시작됩니다. 이 경우 타이머의 id() 값도 변경됩니다.

singleShot 가 true인 경우, 타이머는 한 번만 활성화됩니다.

Qt 6.10부터는 음수의 간격을 설정하면 런타임 경고가 발생하고 값이 1ms로 재설정됩니다. Qt 6.10 이전에는 Qt Timer에서 음수 간격을 설정할 수 있었지만, 예상치 못한 방식으로 동작했습니다(예를 들어, 타이머가 실행 중이면 중지되거나 아예 시작되지 않는 등).

[slot] void QTimer::stop()

타이머를 중지합니다.

start()도 참조하십시오 .

[private signal] void QTimer::timeout()

이 신호는 타이머가 만료될 때 전송됩니다.

interval, start() 및 stop()도 참조하십시오 .

[override virtual protected] void QTimer::timerEvent(QTimerEvent *e)

QObject::timerEvent(QTimerEvent *event)를 재구현합니다.

int QTimer::timerId() const

타이머가 실행 중이면 해당 타이머의 ID를 반환하고, 그렇지 않으면 -1을 반환합니다.