|
||||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Objectcom.nttdocomo.ui.IApplication
com.nttdocomo.ui.MApplication
待ち受けアプリケーションの雛型を提供します。
待ち受けアプリケーションは必ずこのクラスを継承して作成しなければなりません。
このクラスは待ち受けアプリケーションのライフサイクルを定義します。
また、ネイティブの時計の時刻変化に合わせてイベントを発生させることができます。
このクラスを使用してアプリケーションクラスを作成する場合の注意を以下に示します。
なお、待ち受けアプリケーションであっても、通常起動された場合は
IApplication
クラスで定義されるライフサイクルに従います。
その場合、このクラスで定義されるメソッドを呼び出すことはできません。
フィールドの概要 | |
static int |
CLOCK_TICK_EVENT
ネイティブの時計の時刻が変化したことを表すイベントです (=3)。 |
static int |
FOLD_CHANGED_EVENT [iアプリオプションAPI]
折りたたみ状態あるいはフリップの状態が変化したことを表すイベントです (=4)。 |
static int |
MODE_CHANGED_EVENT
アプリケーションが非活性化状態/休眠状態から活性化状態に切り替わったことを 表すイベントです (=1)。 |
static int |
WAKEUP_TIMER_EVENT
アプリケーションが設定した時間だけ経過したことを表すイベントです (=2)。 |
コンストラクタの概要 | |
MApplication()
|
メソッドの概要 | |
void |
deactivate()
アプリケーションを活性化状態から非活性化状態に切り替えます。 |
int |
getWakeupTimer()
待ち受けアプリケーションを休眠モードから非活性化状態に移行するための タイマの値を取得します。 |
boolean |
isActive()
アプリケーションの現在の状態(活性化状態、非活性化状態)を取得します。 |
void |
processSystemEvent(int type,
int param)
待ち受けアプリケーションに関連するイベントが発生した場合に 呼ばれるメソッドです。 |
void |
resetWakeupTimer()
待ち受けアプリケーションを休眠モードから非活性化状態に移行するための タイマを解除します。 |
void |
setClockTick(boolean b)
ネイティブの時計の時刻変化に合わせてイベントを発生させるかどうか指定します。 |
void |
setWakeupTimer(int time)
待ち受けアプリケーションを休眠モードから非活性化状態に移行するための タイマを設定します。 |
void |
sleep()
待ち受けアプリケーションが休眠モードに入ることを JAM に通知します。 |
クラス com.nttdocomo.ui.IApplication から継承したメソッド |
clearMoved, getArgs, getCurrentApp, getLaunchTime, getLaunchType, getParameter, getPushManager, getSourceURL, getSuspendInfo, isMoved, isMovedFromOtherTerminal, launch, resume, setLaunchTime, start, terminate |
クラス Object から継承したメソッド |
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
フィールドの詳細 |
public static final int MODE_CHANGED_EVENT
processSystemEvent(int, int)
メソッドの引数のタイプに渡されます。
パラメータには 0 が渡されます。
public static final int WAKEUP_TIMER_EVENT
processSystemEvent(int, int)
メソッドの引数のタイプに渡されます。
パラメータには、時間通りにイベントが発生した場合は 0 が渡されます。
イベントが発生した時にアプリケーションがサスペンドしていた場合など
イベントの通知が遅延された場合は 1 が渡されます。
public static final int CLOCK_TICK_EVENT
processSystemEvent(int, int)
メソッドの引数のタイプに渡されます。
パラメータには0時0分0秒からの経過時間を秒単位で表した値が渡されます。
例えば 1時23分45秒の場合、1 * 3600 + 23 * 60 + 45 = 5025 が渡されます。
ただし、実際には、分単位でしかイベントは発生しません。
イベントが発生した時にアプリケーションがサスペンドしていた場合は、
イベントは破棄されます。
public static final int FOLD_CHANGED_EVENT [iアプリオプションAPI]
processSystemEvent(int, int)
メソッドの引数のタイプに渡されます。
パラメータには、閉じている場合は0が、開いている場合は1が
渡されます。
[DoJa-5.0 (903i) 以降]
ディスプレイのスタイル (PhoneSystem2.DEV_DISPLAY_STYLE) が変更可能な端末では、
待ち受け i アプリが休眠状態中にディスプレイのスタイルが変更された場合にも発生します。
コンストラクタの詳細 |
public MApplication()
メソッドの詳細 |
public void processSystemEvent(int type, int param)
sleep()
メソッドを呼び出した場合、sleep() メソッドから
戻ったらすみやかにこのメソッドから抜けなければなりません。
type
- イベントのタイプが渡されます。param
- イベントのパラメータが渡されます。
パラメータを持たないイベントの場合は 0 が渡されます。public final void sleep()
IllegalStateException
- 通常実行時に呼ばれた場合や活性化状態時に呼ばれた場合に発生します。
public final void setWakeupTimer(int time)
time
- イベントを発生するまでの時間をミリ秒単位で指定します。
IllegalStateException
- 通常実行時に呼ばれた場合に発生します。
IllegalArgumentException
- 引数 time に 0 未満の値が指定された場合に発生します。
public final int getWakeupTimer()
IllegalStateException
- 通常実行時に呼ばれた場合に発生します。
public final void resetWakeupTimer()
setWakeupTimer(int)
メソッドによりタイマが設定されていない場合は、
何も行わずに無視されます。
IllegalStateException
- 通常実行時に呼ばれた場合に発生します。
public final void setClockTick(boolean b)
b
- イベントを発生させる場合は true を、そうでない場合は false を指定します。
IllegalStateException
- 通常実行時に呼ばれた場合に発生します。
public final void deactivate()
IllegalStateException
- 通常実行時に呼ばれた場合に発生します。
public final boolean isActive()
IllegalStateException
- 通常実行時に呼ばれた場合に発生します。