com.nttdocomo.system.DataBoxFolder
Object
データ BOX のフォルダを管理する手段を提供します。
このクラスのインスタンスは、フォルダの 1 つのエントリを表しますが、 インスタンスを取得する手段はありません。
このクラスに定義されているクラスメソッドの使い方や、
ネイティブのデータへのアクセス方法に関する規定の大原則は
com.nttdocomo.system パッケージの記述を参照して下さい。
ただし、エントリ取得機能 (selectEntry、getEntry)
は提供されません。
エントリ ID のみ取得機能 (selectEntryId) を提供しますが、下記の点が大原則と異なります。
selectEntryIdについて:
このクラスの addEntry(int, String) と selectEntryId(int)
で得られたエントリ ID は、ImageStore.getEntryIds(int) や
MovieStore.getEntryIds(int) でフォルダを指定するために使用されます。
| フィールドの概要 | |
static int |
FOLDER_I_MOTION [iアプリオプションAPI]
データ BOX フォルダ配下のフォルダの種類を表す定数で、 i モーションフォルダを表します(=2)。 |
static int |
FOLDER_MY_PICTURE
データ BOX フォルダ配下のフォルダの種類を表す定数で、 マイピクチャフォルダを表します(=1)。 |
| メソッドの概要 | |
static int |
addEntry(int folder,
String name)
ユーザ操作によりフォルダを新規作成します。 |
static int |
selectEntryId(int folder)
ユーザ操作によりフォルダのエントリ ID を取得します。 |
| クラス Object から継承したメソッド |
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| フィールドの詳細 |
public static final int FOLDER_MY_PICTURE
addEntry(int, String) または selectEntryId(int)
メソッドの引数 folder で利用します。
addEntry(int, String),
selectEntryId(int),
定数フィールド値public static final int FOLDER_I_MOTION [iアプリオプションAPI]
addEntry(int, String) または selectEntryId(int)
メソッドの引数 folder で利用します。
端末によっては、i モーションフォルダへの操作をサポートしていない場合があります。
addEntry(int, String),
selectEntryId(int),
定数フィールド値| メソッドの詳細 |
public static int addEntry(int folder,
String name)
throws InterruptedOperationException
引数 folder に、フォルダの種類として定義されていない値を指定した場合には例外が発生します。 引数 name に指定したフォルダ名について、重複するフォルダ名でフォルダを作成できるかどうかは機種依存です。
フォルダの作成が完了した場合には、このメソッドは 作成されたフォルダのエントリ ID を返します。 ユーザ操作によりキャンセルした場合には -1 を返します。
端末によっては i モーションフォルダへの操作をサポートしていない場合があります。
その場合に引数 folder に FOLDER_I_MOTION が指定された場合は、
例外 UnsupportedOperationException が発生します。
ADF に AccessUserInfo キーの指定が必要です。
上記以外の動作の詳細については、このクラスの説明、
ならびに、その説明から引用されている
com.nttdocomo.system
パッケージに記述されている説明を参照して下さい。
folder - このクラスで定数として定義されたデータ BOX フォルダ配下のフォルダの種類を指定します。name - フォルダ名を指定します。
UnsupportedOperationException - 端末が i モーションフォルダへの操作をサポートしていない場合に発生します。
IllegalStateException - ダウンロード即起動アプリがこのメソッドを呼び出した場合に発生します。
IllegalStateException - 待ち受け実行時の非活性化状態で呼び出された場合に発生します。
IllegalArgumentException - 引数 folder に不正な値が指定された場合に発生します。
SecurityException - ADF に AccessUserInfo キーの指定がないアプリケーションがこのメソッドを呼び出した場合に発生します。
SecurityException - ロック機能などのネイティブ独自のセキュリティ設定により、
フォルダが作成できない場合に発生します。
UIM 内情報を用いた実行制限がかけられている場合も含みます。
InterruptedOperationException - 競合条件などにより、フォルダ作成の操作が異常終了した場合に発生します。
public static int selectEntryId(int folder)
throws InterruptedOperationException
引数 folder に、フォルダの種類として定義されていない値を指定した場合には例外が発生します。
端末によっては i モーションフォルダへの操作をサポートしていない場合があります。
その場合に引数 folder に FOLDER_I_MOTION が指定された場合は、
例外 UnsupportedOperationException が発生します。
ADF に AccessUserInfo キーの指定が必要です。
上記以外の動作の詳細については、このクラスの説明、
ならびに、その説明から引用されている
com.nttdocomo.system
パッケージに記述されている説明を参照して下さい。
folder - このクラスで定数として定義されたデータ BOX フォルダ配下のフォルダの種類を指定します。
UnsupportedOperationException - 端末が i モーションフォルダへの操作をサポートしていない場合に発生します。
IllegalStateException - ダウンロード即起動アプリがこのメソッドを呼び出した場合に発生します。
IllegalStateException - 待ち受け実行時の非活性化状態で呼び出された場合に発生します。
IllegalArgumentException - 引数 folder に不正な値が指定された場合に発生します。
SecurityException - ADF に AccessUserInfo キーの指定がないアプリケーションが
このメソッドを呼び出した場合に発生します。
SecurityException - ロック機能などのネイティブ独自のセキュリティ設定により、
画像データのエントリ ID を取得できない場合に発生します。
InterruptedOperationException - 競合条件などにより、選択操作が異常終了した場合に発生します。