com.nttdocomo.system
クラス Schedule

Object
  |
  +--com.nttdocomo.system.Schedule

public final class Schedule

extends Object

携帯電話のネイティブのスケジューラ機能にアクセスする手段を提供します。

スケジュールデータの新規登録機能を提供します。 ネイティブデータへのアクセス機能の基本については、 XObjectクラスの説明を参照してください。

スケジュールデータを新規に登録するためには、 addEntry メソッドに内容、スケジュール時刻、アラーム通知の有無を渡します。 登録はネイティブのユーザインタフェースを介して行われます。

ScheduleDateクラスにより、 「1回限り」 「毎日」 「毎週」 「毎月」 「毎年」のスケジュール時刻を設定できます。 しかし、サポートされるスケジュールタイプは、 ネイティブのスケジューラ機能に依存します。

ミニマムスペック:

• ミニマムスペックでは、「1回限り」のスケジュール時刻を設定可能です。
• ミニマムスペックでは、1件あたり100文字までのスケジュール内容を登録できます。

導入されたバージョン:

DoJa-3.0

メソッドの概要

static boolean	addEntry(String description, ScheduleDate date, boolean alarm) ユーザ操作によりスケジュールを新規登録します。
static int	getSupportedTypes() サポートしているスケジュール時刻のタイプを取得します。

クラス Object から継承したメソッド

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

メソッドの詳細

getSupportedTypes

public static int getSupportedTypes()

サポートしているスケジュール時刻のタイプを取得します。 ONETIME、 DAILY、 WEEKLY、 MONTHLY、 YEARLY のうち、 サポートされているスケジュール時刻タイプ(日時指定タイプ)の論理和を返します。 例えば、「1回限り」「毎日」「毎週」をサポートしている場合、
7( = ONETIME|DAILY|WEEKLY)
が返ります。

戻り値:

サポートしているスケジュール時刻のタイプを返します。

addEntry

public static boolean addEntry(String description,
                               ScheduleDate date,
                               boolean alarm)
                        throws InterruptedOperationException

ユーザ操作によりスケジュールを新規登録します。 各引数(alarm以外)はnullでもかまいません。 date引数がnullの場合、 スケジュール登録画面が起動された日付が指定されたことになります。 時刻については機種依存です。

ADFにAccessUserInfoキーの指定が必要です。 このメソッドを呼び出すとサスペンドします。

パラメータ:

description - 内容(通常文字列)を指定します。

date - スケジュール日時を指定します。

alarm - アラームを鳴らすか否か指定します。 trueの場合、アラームを鳴らします。

戻り値:

登録が成功したか否かを返します。 登録が成功した場合にのみ、true を返します。

例外:

IllegalStateException - ダウンロード即起動アプリがこのメソッドを呼び出した場合に発生します。

IllegalStateException - 待ち受け実行時の非活性化状態で呼び出された場合に発生します。

IllegalArgumentException - サポートされない範囲の日時の起動時刻 (例えば、1900年など)を指定した場合に発生します。

SecurityException - ADFにAccessUserInfoキーの指定がないアプリケーションが このメソッドを呼び出した場合に発生します。

SecurityException - ロック機能などのネイティブ独自のセキュリティ設定により、 スケジュールを登録できない場合に発生します。

InterruptedOperationException - 競合条件などにより、登録操作が異常終了した場合に発生します。