com.nttdocomo.system
クラス Schedule

Object
  com.nttdocomo.system.Schedule

public final class Schedule

extends Object

携帯電話のネイティブのスケジューラ機能にアクセスする手段を提供します。 このクラスのインスタンスは、 携帯電話のネイティブのスケジュールデータの 1 つのエントリを表しますが、 インスタンスを取得する手段はありません。

このクラスに定義されているクラスメソッドの使い方や、 ネイティブのデータへのアクセス方法に関する規定の大原則は com.nttdocomo.system パッケージの記述を参照して下さい。 ただし、エントリ取得機能 (selectEntry、getEntry) は提供されず、 エントリ登録機能 (addEntry(String, ScheduleDate, boolean)) についても、 下記の点が大原則と異なります。

addEntry の戻り値について:

このクラスにおいては、addEntryの戻り値として、 エントリ ID ではなく、登録成否を表す論理値が返されます。

エントリ登録時の改行文字の扱いについて:

改行文字 (単独の "\n"、 単独の "\r"、または "\r\n") は、 大原則では「登録できない文字」として扱われますが、 スケジュールの内容 (description 引数) には改行が登録可能な実装もあります。
改行が登録可能な実装の場合は、 いずれの改行文字も 1 つの改行として扱われます。 改行が登録不可能な実装の場合は、 大原則通り、空白や '?' に置換されたり、削られたりします。

エントリ登録時に、引数 date に渡す ScheduleDate オブジェクトの設定により、 「1回限り」 「毎日」 「毎週」 「毎月」 「毎年」のスケジュール時刻を設定できます。 ただし、 サポートされるスケジュールタイプは、 ネイティブのスケジューラ機能に依存します。 この端末でサポートされるスケジュールタイプを取得するには、 getSupportedTypes() を利用して下さい。

ミニマムスペック:

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

導入されたバージョン:

DoJa-3.0 (505i)

メソッドの概要

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()

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

戻り値:

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

addEntry

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

ユーザ操作によりスケジュールを新規登録します。

date 引数が null の場合、 スケジュール登録画面が起動された日付が指定されたことになります。 その場合に時刻がいつに設定されるかは機種依存です。

ADFにAccessUserInfoキーの指定が必要です。 上記以外の動作の詳細については、このクラスの説明、 ならびに、その説明から引用されている com.nttdocomo.system パッケージに記述されている説明を参照して下さい。

[DoJa-4.0 (901i) 以降]
データ保存領域の容量を超えているために登録できない場合は、 ユーザが登録操作をキャンセルした場合と同様の値を返します。

パラメータ:

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

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

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

戻り値:

登録が成功したか否かを返します。 登録が成功した場合にのみ、true を返します。 ユーザが登録操作をキャンセルした場合、false を返します。

例外:

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

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

IllegalArgumentException - サポートされない日時指定タイプの起動時刻を 指定した場合に発生します。

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

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

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

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