Back to Qt.io
Contact Us Blog Download Qt

Timer QML Type

지정된 간격으로 핸들러를 트리거합니다. 더 보기...

Import Statement: import QtQml

속성

신호

방법

자세한 설명

타이머는 한 번 또는 지정된 간격으로 반복적으로 동작을 트리거하는 데 사용할 수 있습니다.

다음은 현재 날짜와 시간을 표시하고 500밀리초마다 텍스트를 업데이트하는 타이머입니다. 이 타이머는 JavaScript Date 객체를 사용하여 현재 시간에 액세스합니다.

import QtQuick 2.0

Item {
    Timer {
        interval: 500; running: true; repeat: true
        onTriggered: time.text = Date().toString()
    }

    Text { id: time }
}

타이머 유형은 애니메이션 타이머와 동기화됩니다. 애니메이션 타이머는 일반적으로 60fps로 설정되므로 타이머의 해상도는 최대 16ms입니다.

타이머가 실행 중이고 속성 중 하나가 변경되면 경과 시간이 재설정됩니다. 예를 들어 간격이 1000밀리초인 타이머가 시작 후 500밀리초 후에 반복 속성이 변경되면 경과 시간이 0으로 초기화되고 1000밀리초 후에 타이머가 트리거됩니다.

Qt Quick 데모 - 시계를참조하세요 .

속성 문서

interval : int

트리거 사이의 interval 간격을 밀리초 단위로 설정합니다.

기본 간격은 1000밀리초입니다.


repeat : bool

repeat 이 참이면 타이머가 지정된 간격으로 반복적으로 트리거되고, 그렇지 않으면 타이머가 지정된 간격에 한 번 트리거된 후 중지됩니다(즉, 실행이 false로 설정됨).

repeat 기본값은 false입니다.

running 를참조하세요 .


running : bool

true로 설정하면 타이머를 시작하고, 그렇지 않으면 타이머를 중지합니다. 반복되지 않는 타이머의 경우 타이머가 트리거된 후 running 은 false로 설정됩니다.

running 기본값은 false입니다.

repeat도 참조하세요 .


triggeredOnStart : bool

타이머가 시작되면 첫 번째 트리거는 일반적으로 지정된 간격이 경과한 후입니다. 타이머가 시작될 때 즉시 트리거하는 것이 바람직한 경우도 있습니다(예: 초기 상태를 설정하기 위해).

triggeredOnStart 이 참이면 타이머가 시작될 때 즉시 트리거되고 이후 지정된 간격에 따라 트리거됩니다. 반복을 false로 설정하면 타이머가 시작 시 한 번, 그리고 간격에 따라 한 번씩 두 번 트리거됩니다.

triggeredOnStart 기본값은 false입니다.

running 를참조하세요 .


신호 문서

triggered()

타이머가 시간 초과되면 이 신호가 발생합니다.

참고: 해당 핸들러는 onTriggered 입니다.


메서드 문서

restart()

타이머를 다시 시작합니다.

타이머가 실행 중이 아니라면 시작되고, 그렇지 않으면 중지되고 초기 상태로 재설정된 후 시작됩니다. running 속성은 restart() 을 호출한 후 참이 됩니다.


start()

타이머를 시작합니다.

타이머가 이미 실행 중인 경우 이 메서드를 호출해도 아무런 효과가 없습니다. running 속성은 start() 을 호출한 후에 참이 됩니다.


stop()

타이머를 중지합니다.

타이머가 실행 중이 아닌 경우 이 메서드를 호출해도 아무런 효과가 없습니다. stop() 을 호출하면 running 속성은 거짓이 됩니다.


© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.