com.docomostar.ui
クラス ImageLabel

Object
  com.docomostar.ui.Component
      com.docomostar.ui.ImageLabel

public final class ImageLabel
extends Component

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

コンポーネントのサイズが指定されているとき、 イメージのサイズがコンポーネントのサイズより小さい場合、 イメージはコンポーネントの中央に表示されます。 また、コンポーネントのサイズがイメージのサイズより小さい場合、 イメージは左上からコンポーネントのサイズ分だけクリッピングして表示されます。

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

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

導入されたバージョン:

Star-1.0

関連項目:

Label, ImageButton

コンストラクタの概要

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

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

メソッドの概要

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

クラス com.docomostar.ui.Component から継承されたメソッド

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

クラス Object から継承されたメソッド

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

コンストラクタの詳細

ImageLabel

public ImageLabel()

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

ImageLabel

public ImageLabel(Image image)

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

パラメータ:

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

例外:

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

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

メソッドの詳細

setImage

public void setImage(Image image)

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

パラメータ:

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

例外:

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

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