com.nttdocomo.ui
クラス Image

Object
  |
  +--com.nttdocomo.ui.Image
直系の既知のサブクラス:
PalettedImage

public abstract class Image
extends Object

イメージを定義します。 イメージ クラスは、静止画像を表すクラスの抽象クラスです。
[DoJa-1.0]
dispose メソッドを呼び出した後にそのオブジェクトに対して何らかのメソッドを呼び出した場合や このオブジェクトを Graphics クラスの drawImage メソッドに引数として渡した場合の動作は機種依存です。
[DoJa-2.0]
dispose メソッドを呼び出した後に、そのオブジェクトに対して dispose 以外のメソッドを呼び出した場合や、他のクラスのイメージを引数に取るメソッドに引数として渡した場合は例外が発生します。


[DoJa-2.0]
createImage メソッドで生成したイメージを ImageButton, ImageLabel, AnchorButton に セットした状態で getGraphics メソッドで取り出した Graphics オブジェクトで描画した場合に どのタイミングで画面に反映されるかは機種依存です。
[DoJa-3.0]
createImage メソッドで生成したイメージを ImageButton, ImageLabel, AnchorButton に セットした状態で getGraphics メソッドで取り出した Graphics オブジェクトで描画した場合、 少なくとも以下のタイミングで画面に反映されます。


コンストラクタの概要
protected Image()
          アプリケーションが直接このクラスのインスタンスを生成することはできません。
 
メソッドの概要
static Image createImage(int width, int height)
           イメージを新たに生成します。
static Image createImage(int width, int height, int[] data, int off)
           RGB配列を指定してイメージオブジェクトを生成します。
abstract  void dispose()
          イメージを破棄します。
 Graphics getGraphics()
           イメージに描画するためのグラフィックスオブジェクトを取得します。
 int getHeight()
          イメージの高さを取得します。
 int getWidth()
          イメージの幅を取得します。
 
クラス Object から継承したメソッド
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

コンストラクタの詳細

Image

protected Image()
アプリケーションが直接このクラスのインスタンスを生成することはできません。

メソッドの詳細

createImage

public static Image createImage(int width,
                                int height)
イメージを新たに生成します。 生成されたイメージの画素は、Canvas のデフォルトの背景色と同じ色で埋められています。

取り出したイメージオブジェクトに対してgetGraphics()メソッドを実行することができます。

パラメータ:
width - 生成するイメージの幅を指定します。
height - 生成するイメージの高さを指定します。
戻り値:
生成されたイメージを返します。
例外:
IllegalArgumentException - 引数 width, height のどちらかまたは両方に 0 以下の値が指定された場合に発生します。
導入されたバージョン:
DoJa-2.0

createImage

public static Image createImage(int width,
                                int height,
                                int[] data,
                                int off)
RGB配列を指定してイメージオブジェクトを生成します。

createImage(width, height)でイメージを生成し、 そのイメージのGraphicsオブジェクトに対して setRGBPixels(0, 0, width, height, data, off)を実行することと同じです。

取り出したイメージオブジェクトに対してgetGraphics()メソッドを実行することができます。

パラメータ:
width - イメージの幅を指定します。
height - イメージの高さを指定します。
data - 書き込むピクセル値の配列を指定します。
off - 配列中の開始位置を指定します。
戻り値:
イメージオブジェクトを返します。
例外:
NullPointerException - 引数 data が null の場合に発生します。
IllegalArgumentException - 引数 width、heightのどちらかまたは両方が0以下の場合に発生します。
ArrayIndexOutOfBoundsException - 引数 off が 0未満の場合、 または引数 data のインデックス off 以降の長さがwidth * height より短い場合に発生します。
導入されたバージョン:
DoJa-3.0

getWidth

public int getWidth()
イメージの幅を取得します。

戻り値:
イメージの幅を返します。

getHeight

public int getHeight()
イメージの高さを取得します。

戻り値:
イメージの高さを返します。

dispose

public abstract void dispose()
イメージを破棄します。
[DoJa-1.0]
このメソッドを呼び出した後にこのオブジェクトにアクセスした場合の振舞は機種依存です。
[DoJa-2.0]
このメソッドを呼び出した後に dispose 以外のメソッドを呼び出した場合は UIException が発生します(ILLEGAL_STATE)。 このメソッドを呼び出した後に dispose メソッドを呼び出した場合は何もしません。


getGraphics

public Graphics getGraphics()
イメージに描画するためのグラフィックスオブジェクトを取得します。 Image.createImage(int, int)Image.createImage(int, int, int[], int) で生成されたイメージに対してのみ呼び出すことができます。 取得されたグラフィックスオブジェクトは初期状態になっています。 getGraphics メソッドを呼び出すたびに新しいオブジェクトを生成して返します。

戻り値:
イメージに描画するためのグラフィックスオブジェクトを返します。
例外:
UnsupportedOperationException - createImage() で生成されたイメージ以外の イメージに対して呼び出した場合に発生します。
導入されたバージョン:
DoJa-2.0


NTT DoCoMo,Inc.

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

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

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