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が実行中にプロパティの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()

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

メソッド・ドキュメント

void restart()

タイマーの再起動

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

void start()

タイマーを開始する。

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

void stop()

タイマーを停止する

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