com.docomostar.system.ImageStore
|
|||||||||
| 前のクラス 次のクラス | フレームあり フレームなし | ||||||||
| 概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド | ||||||||
Object
public final class ImageStore
携帯電話のネイティブの画像データ管理機能にアクセスする手段を提供します。 このクラスのインスタンスは、 携帯電話のネイティブの画像データの 1 つのエントリを表します。
このクラスに定義されているクラスメソッドの使い方や、
ネイティブのデータへのアクセス方法に関する規定の大原則は
com.docomostar.system パッケージの記述を参照して下さい。
画像データのエントリからは、エントリ ID を取得することが出来るほか、
画像をメディアイメージオブジェクトとして取り出したり、
画像のファイルイメージを取り出すための InputStream
を取得することができます。
また、得られたエントリ ID を
PhoneTheme.setImageTheme(int, int)
メソッドの引数に指定することにより、
そのエントリの画像を待ち受け画像などに設定することができます。
| メソッドの概要 | |
|---|---|
static int |
addEntry(MediaImage image)
ユーザ操作により画像データを新規登録します。 |
static int[] |
addEntry(MediaImage[] images) [iアプリオプションAPI]
ユーザ操作により複数の画像データを新規登録します。 |
static int |
addEntry(MediaImage image,
boolean exclusive)
ユーザ操作により画像データを新規登録します。 |
static ImageStore |
getEntry(int id)
画像データのエントリを取得します。 |
static int[] |
getEntryIds(int folderId)
画像データのエントリ ID のリストを取得します。 |
int |
getId()
画像データのエントリIDを取得します。 |
MediaImage |
getImage()
画像データのエントリのイメージをメディアイメージとして取得します。 |
java.io.InputStream |
getInputStream()
画像データのエントリのイメージをファイルイメージとして取り出すための 入力ストリームを取得します。 |
static ImageStore |
selectEntry()
ユーザ操作により画像データのエントリを取得します。 |
static int |
selectEntryId() [iアプリオプションAPI]
ユーザ操作により画像データのエントリIDを取得します。 |
| クラス Object から継承されたメソッド |
|---|
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| メソッドの詳細 |
|---|
public static ImageStore selectEntry()
throws InterruptedOperationException
ADFにAccessUserInfoキーの指定が必要です。
上記以外の動作の詳細については、このクラスの説明、
ならびにその説明から引用されている
com.docomostar.system パッケージに記述されている
「エントリ取得時の振る舞い」の説明を参照して下さい。
端末によっては、このメソッドにより Flash® コンテンツを取得できます。
SecurityException -
SecurityException -
MediaException - InterruptedOperationException -
public static int selectEntryId()
throws InterruptedOperationException [iアプリオプションAPI]
このメソッドで得られたエントリ ID を
PhoneTheme.setImageTheme(int, int)
メソッドの引数に指定することにより、
そのエントリの画像を待ち受け画像などに設定することができます。
パーミッションとしてテーマ設定が許可されているトラステッドStar アプリのみ
このメソッドを呼び出すことができます。
上記以外の動作の詳細については、
com.docomostar.system
パッケージに記述されている説明を参照してください。
端末によっては、このメソッドをサポートしていない場合があります。 その場合には、例外 UnsupportedOperationException が発生します。
UnsupportedOperationException -
SecurityException -
InterruptedOperationException -
public static ImageStore getEntry(int id)
throws StoreException
ADFにAccessUserInfoキーの指定が必要です。
上記以外の動作の詳細については、このクラスの説明、
ならびにその説明から引用されている
com.docomostar.system パッケージに記述されている
「エントリ取得時の振る舞い」の説明を参照して下さい。
端末によっては、このメソッドにより Flash® コンテンツを取得できます。
id - 取得する画像データのエントリIDを指定します。
SecurityException -
SecurityException -
StoreException - MediaException -
public static int[] getEntryIds(int folderId)
throws StoreException
ユーザの選択によらず、 フォルダのエントリ ID を引数 folderId に指定して、 フォルダ直下にある画像データのエントリ ID のリストを取得します。 なお、アプリケーションがサスペンドすることなく、エントリ ID のリストを取得できます。
フォルダのエントリ ID は DataBoxFolder クラスのメソッドにより取得することができます。
引数で指定したエントリ ID のフォルダが、
データ BOX フォルダ配下のマイピクチャフォルダ直下に存在しない場合に例外が発生します。
このメソッドでエントリ ID のリストの対象となる画像データは、
getEntry(int)、 selectEntry() で取得可能な画像データです。
エントリ ID のリストの対象とならない画像データが、
引数 folderId で指定されたフォルダ直下にある場合には、
このメソッドは例外を発生せずに、それらのエントリ ID を除いたリストを返します。
ADF に AccessUserInfo キーの指定が必要です。
folderId - フォルダのエントリ ID を指定します。
SecurityException -
SecurityException -
StoreException -
public static int addEntry(MediaImage image)
throws InterruptedOperationException
ユーザ操作により画像データを新規登録します。
引数に指定された画像が保持している再配布可能かどうかの設定のままで保存されます。
すなわち、addEntry(image, !image.isRedistributable())
を呼び出すことと等価です。
image - 登録する画像のメディアイメージを指定します。
NullPointerException -
MediaException - MediaImageインタフェースを実装した未知のクラスのオブジェクト)
が渡された場合に発生します。
MediaException - MediaException - SecurityException -
SecurityException -
MediaException - MediaException - MediaException - InterruptedOperationException -
public static int[] addEntry(MediaImage[] images)
throws InterruptedOperationException [iアプリオプションAPI]
ユーザ操作により複数の画像データを新規登録します。
引数に指定された配列内の全ての画像データを、
それぞれの画像が保持している再配布可能かどうかの設定のままで保存します。
原理的には、
int[] ret = new int[images.length];
for (int i = 0; i < images.length; i++) {
ret[i] = addEntry(images[i], !images[i].isRedistributable());
}
を行うことで、同等な処理を実現出来ますが、以下の点が異なります。
このメソッドをサポートしていない実装も存在します。 その場合には、例外 UnsupportedOperationException が発生します。 また、一度に登録できる画像の数は機種依存です。 実装が一度に登録可能な画像数を超える長さの配列が指定された場合には、例外が発生します。 また、実装が一度に登録可能な画像合計データサイズを超える配列が指定された場合にも、例外が発生します。
引数 images に、長さ 0 の配列を指定しても、 それを理由に例外が発生することはありません。 その場合はサスペンドせずに null が返されます。
images - 登録する画像のメディアイメージの配列を指定します。
int[] ids とすると、
images[i] に対応するエントリ ID は、
ids[i] に格納されています。
UnsupportedOperationException -
NullPointerException -
MediaException - NullPointerException -
MediaException -