Timer QML Type

指定した間隔でハンドラをトリガする。詳細...

Import Statement: import QtQml

継承されたメンバーを含む全メンバーのリスト

プロパティ

interval : int
repeat : bool
running : bool
triggeredOnStart : bool

信号

triggered()

方法

restart()
start()
stop()

詳細説明

タイマーは、1回だけ、または与えられた間隔で繰り返しアクションをトリガーするために使用することができます。

ここでは、現在の日付と時刻を表示し、500ミリ秒ごとにテキストを更新するタイマーを示します。JavaScriptのDate オブジェクトを使用して、現在の時刻にアクセスします。

import QtQuick 2.0

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

    Text { id: time }
}

Timerタイプはアニメーションタイマーと同期しています。アニメーションタイマーは通常60fpsに設定されているので、Timerの解像度はせいぜい16msです。

Timerが実行中にプロパティの1つが変更されると、経過時間はリセットされます。例えば、インターバルが1000msのTimerが、開始から500ms後にrepeatプロパティを変更した場合、経過時間は0にリセットされ、Timerは1000ms後にトリガーされます。

Qt Quick Demo - Clocksも参照してください。

プロパティの説明

interval : int

interval トリガー間隔をミリ秒単位で設定します。

デフォルトの間隔は1000ミリ秒です。

repeat : bool

repeat がtrueの場合、タイマーは指定された間隔で繰り返しトリガーされます。そうでない場合、タイマーは指定された間隔で一度トリガーされ、その後停止します（つまり、runningはfalseに設定されます）。

repeat デフォルトはfalseである。

runningも参照のこと。

running : bool

trueに設定するとタイマーを開始し、そうでなければタイマーを停止する。非繰り返しタイマーの場合、タイマーがトリガーされた後、running はfalseに設定される。

running のデフォルトはfalseである。

repeatも参照のこと。

triggeredOnStart : bool

タイマーが開始されると、最初のトリガーは通常、指定された間隔が経過した後になる。タイマーが開始されたとき、初期状態を確立するためなど、すぐにトリガーすることが望ましい場合もある。

triggeredOnStart がtrueの場合、タイマーは開始されると即座にトリガーされ、その後は指定された間隔でトリガーされる。repeatをfalseに設定すると、タイマーは2回トリガーされる。

triggeredOnStart デフォルトはfalseである。

runningも参照のこと。

シグナル・ドキュメント

triggered()

このシグナルはタイマーがタイムアウトしたときに発せられます。

注意： 対応するハンドラはonTriggered です。

メソッドの説明

restart()

タイマーを再起動する

タイマーが実行中でない場合は開始され、そうでない場合は停止され、初期状態にリセットされてから開始されます。restart() を呼び出すと、running プロパティは true になります。

start()

タイマーの開始

タイマーがすでに実行されている場合、このメソッドを呼び出しても何の効果もありません。start() への呼び出し後、running プロパティは真になります。

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.