com.nttdocomo.ui
クラス ImageLabel

java.lang.Object
  |
  +--com.nttdocomo.ui.Component
        |
        +--com.nttdocomo.ui.ImageLabel

public final class ImageLabel

extends Component

イメージを表示するコンポーネントを定義します。 画像ラベル クラスは、 高レベル API で使用するUI部品の一つで、静止画像を表示するためのコンポーネントです。 静止画像が設定されていないイメージラベルは、背景色で塗りつぶされます。

[DoJa-1.0]
コンポーネントのサイズが指定されているとき、 イメージのサイズがコンポーネントのサイズより小さい場合、 イメージがどの位置に表示されるかは機種依存です。 典型的な実装では、コンポーネントの中央に表示されます。 また、コンポーネントのサイズがイメージのサイズより小さい場合の振舞は、 機種依存です。
[DoJa-2.0]
コンポーネントのサイズが指定されているとき、 イメージのサイズがコンポーネントのサイズより小さい場合、 イメージはコンポーネントの中央に表示されます。 また、コンポーネントのサイズがイメージのサイズより小さい場合、 イメージは左上からコンポーネントのサイズ分だけクリッピングして表示されます。

このクラスのインスタンスが生存している間、このインスタンスが参照しているImageクラスの インスタンスを利用不可能な状態にしてはいけません。すなわち、MediaImageのインスタンスから getImageメソッドでイメージオブジェクトをとりだした場合、ImageLabelのインスタンスの 使用がおわってから、unuseメソッド, disposeメソッドを発行してください。

 ...
 MediaImage img = MediaManager.getImage( ... );
 img.use();
 ImageLabel label = new ImageLabel(img.getImage());
 ...
 // labelの使用が終了 
 img.unuse();
 img.dispose();
 ...

なお、設定されているImageクラスのインスタンスが保持するイメージが無効になっている場合、 イメージは描画されません。そのとき、ラベルは背景色で塗りつぶされます。

関連項目:

Label, ImageButton

コンストラクタの概要

ImageLabel()
ラベル画像を指定しないでラベルを生成します。

ImageLabel(Image image)
ラベル画像を指定してラベルを生成します。

メソッドの概要

void	setImage(Image image) コンポーネントのラベル画像を設定します。

クラス com.nttdocomo.ui.Component から継承したメソッド

getHeight, getWidth, getX, getY, setBackground, setForeground, setLocation, setSize, setVisible

クラス java.lang.Object から継承したメソッド

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

ImageLabel

public ImageLabel()

ラベル画像を指定しないでラベルを生成します。 生成時は、表示可能になっています。 表示可能、表示不能を設定するには、setVisibleメソッドを使用します。

ImageLabel

public ImageLabel(Image image)

ラベル画像を指定してラベルを生成します。 生成時は、表示可能になっています。 表示可能、表示不能を設定するには、setVisibleメソッドを使用します。

パラメータ:

image - ラベル画像を指定します。

例外:

NullPointerException - [DoJa-2.0] 引数 image に null が指定された場合に発生します。

UIException - [DoJa-2.0] 引数 image に既に dispose されているイメージが指定された場合に発生します(ILLEGAL_STATE)。

メソッドの詳細

setImage

public void setImage(Image image)

コンポーネントのラベル画像を設定します。

パラメータ:

image - ラベル画像を指定します。

例外:

NullPointerException - [DoJa-2.0] 引数 image に null が指定された場合に発生します。

UIException - [DoJa-2.0] 引数 image に既に dispose されているイメージが指定された場合に発生します(ILLEGAL_STATE)。