タイマのインタフェースを定義します。 このインタフェースは、 タイマを実装するクラスが持つべきインタフェースを規定します。
タイマの実装は、 指定された時間が経過した時点でタイマイベントを発生し、 そのイベントを、何らかの方法でアプリケーションに通知します。 このタイマイベント発生時間間隔の指定方法や、イベントの通知方法は、 このインタフェースでは定義しません。
[DoJa-4.0 (901i) 以降]
なお、アプリケーション開発者が指定した通りの時間間隔では、
タイマイベントを発生できない実装も存在するため、
このインタフェースではそのような機種依存情報を取得するためのメソッドを用意しています。
はじめに、以下の2つの用語を定義します。
ShortTimer.getShortTimer(Canvas canvas,
int id, int time, boolean repeat) や、
Timer.setTime(int time) の time 引数に指定する値が該当します。
このインタフェースでは、
実装サポート値の集合を等差数列としてモデル化しており、
getMinTimeInterval() がその初項を、
getResolution() がその公差を、それぞれ表します。
すなわち、実装サポート値の集合は、
{ Ti | Ti = getMinTimeInterval() + getResolution() * i } (i = 0, 1, 2, ...)
となります。 実装サポート値以外の値をタイマイベント発生時間間隔として指定した場合の振る舞いは、 このインタフェースでは定義しません。各実装クラスの説明を参照して下さい。
| メソッドの概要 | |
void |
dispose()
タイマを破棄します。 |
int |
getMinTimeInterval()
サポートしているタイマイベント発生時間間隔の中で最小のものを取得します。 |
int |
getResolution()
タイマの解像度を取得します。 |
void |
start()
タイマを開始します。 |
void |
stop()
タイマを停止します。 |
| メソッドの詳細 |
public int getResolution()
タイマの解像度を取得します。
タイマイベント発生時間間隔の実装サポート値は、
等差数列によってモデル化できますが、
その数列の公差をタイマの解像度と定義します。
詳細については TimeKeeper インタフェースの説明
を参照して下さい。
なお、タイマの解像度は、実装によって異なります。
public int getMinTimeInterval()
サポートしているタイマイベント発生時間間隔の中で最小のものを取得します。
タイマイベント発生時間間隔の実装サポート値は、
等差数列によってモデル化できますが、
その数列の初項の値を取得します。
詳細については TimeKeeper インタフェースの説明
を参照して下さい。
なお、取得できる値は実装によって異なります。
public void start()
public void stop()
public void dispose()