Timer QML Type

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

Import Statement: import QtQml

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

プロパティ

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

シグナル

triggered()

メソッド

restart()
start()
stop()

詳細説明

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

ここでは、現在の日付と時刻を表示し、500ミリ秒ごとにテキストを更新するTimerを示します。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にリセットされ、1000ms後にTimerがトリガーされます。

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 プロパティは false になります。

本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の商標です。その他すべての商標は、それぞれの所有者に帰属します。