Timer QML Type

指定された間隔でハンドラを実行します。詳細...

• 継承されたメンバーを含む、すべてのメンバーの一覧

プロパティ

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

信号

• triggered()

方法

• void restart()
• void start()
• void 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が実行中にそのプロパティのいずれかが変更されると、経過時間はリセットされます。 たとえば、間隔が1000msのTimerが開始から500ms後にrepeatプロパティを変更された場合、経過時間は0にリセットされ、Timerは1000ms後にトリガーされます。

Qt Quick のデモ「Clocks」も参照してください 。

プロパティのドキュメント

interval : int

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

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

repeat : bool

repeat がtrueの場合、タイマーは指定された間隔で繰り返し作動します。そうでない場合、タイマーは指定された間隔で1回だけ作動した後、停止します（つまり、runningがfalseに設定されます）。

repeat デフォルトは false です。

「running」も参照してください 。

running : bool

true に設定するとタイマーが開始され、それ以外の場合はタイマーが停止します。繰り返し機能のないタイマーの場合、タイマーが起動した後は、running が false に設定されます。

running デフォルトは false です。

repeatも参照してください 。

triggeredOnStart : bool

タイマーが開始されると、通常、最初のトリガーは指定された間隔が経過した後に発生します。ただし、初期状態を設定する場合など、タイマー開始時に即座にトリガーを発生させたい場合もあるでしょう。

triggeredOnStart がtrueの場合、タイマーは開始時に直ちにトリガーされ、その後は指定された間隔ごとにトリガーされます。なお、repeatがfalseに設定されている場合、タイマーは2回トリガーされます。1回目は開始時、2回目は指定された間隔ごとにトリガーされます。

triggeredOnStart デフォルトは false です。

runningも参照してください 。

Signal のドキュメント

triggered()

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

メソッドのドキュメント

void restart()

タイマーを再起動します

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

void start()

タイマーを開始します

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

void stop()

タイマーを停止します

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