概要  パッケージ   クラス  階層ツリー  非推奨 API  索引  ヘルプ 
 前のクラス   次のクラス フレームあり    フレームなし    
概要:  入れ子 | フィールド | コンストラクタ | メソッド 詳細:  フィールド | コンストラクタ | メソッド

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() を利用して下さい。

ミニマムスペック:

導入されたバージョン:
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) 以降]
データ保存領域の容量を超えているために登録できない場合は、 ユーザが登録操作をキャンセルした場合と同様の値を返します。

[DoJa-5.1 (905i) 以降]
このメソッドは、引数 date の時間フィールドに設定されている値を、 ネイティブのスケジュール機能にそのまま渡します。 すなわち、ScheduleDate オブジェクトにはタイムゾーン情報がないため、 同オブジェクトに設定されている日時はローカルタイムとして渡されます。

パラメータ:
description - 内容(通常文字列)を指定します。
date - スケジュール日時を指定します。
alarm - アラームを鳴らすか否か指定します。 trueの場合、アラームを鳴らします。
戻り値:
登録が成功したか否かを返します。 登録が成功した場合にのみ、true を返します。 ユーザが登録操作をキャンセルした場合、false を返します。
例外:
IllegalStateException - ダウンロード即起動アプリがこのメソッドを呼び出した場合に発生します。
IllegalStateException - 待ち受け実行時の非活性化状態で呼び出された場合に発生します。
IllegalArgumentException - サポートされない日時指定タイプの起動時刻を 指定した場合に発生します。
IllegalArgumentException - サポートされない範囲の日時の起動時刻 (例えば、1900年など)を指定した場合に発生します。
SecurityException - ADFにAccessUserInfoキーの指定がないアプリケーションが このメソッドを呼び出した場合に発生します。
SecurityException - ロック機能などのネイティブ独自のセキュリティ設定により、 スケジュールを登録できない場合に発生します。
InterruptedOperationException - 競合条件などにより、登録操作が異常終了した場合に発生します。
概要  パッケージ   クラス  階層ツリー  非推奨 API  索引  ヘルプ 
 前のクラス   次のクラス フレームあり    フレームなし    
概要:  入れ子 | フィールド | コンストラクタ | メソッド 詳細:  フィールド | コンストラクタ | メソッド

NTT DOCOMO,INC.

本製品または文書は著作権法により保護されており、その使用、複製、再頒布および逆コンパイルを制限するライセンスのもとにおいて頒布されます。NTTドコモ（その他に許諾者がある場合は当該許諾者も含めて）の書面による事前の許可なく、本製品および関連する文書のいかなる部分も、いかなる方法によっても複製することが禁じられます。フォントを含む第三者のソフトウェアは、著作権法により保護されており、その提供者からライセンスを受けているものです。

Sun、Sun Microsystems、Java、J2MEおよびJ2SEは、米国およびその他の国における米国 Sun Microsystems,Inc.の商標または登録商標です。サンのロゴマークは、米国 Sun Microsystems, Inc.の登録商標です。

FeliCaは、ソニー株式会社が開発した非接触ICカードの技術方式です。FeliCaは、ソニー株式会社の登録商標です。

「ｉモード」、「ｉアプリ／アイアプリ」、「ｉ-αppli」ロゴ、「DoJa」はNTTドコモの商標または登録商標です。

その他記載された会社名、製品名などは該当する各社の商標または登録商標です。