Java プラットフォーム 1.2

javax.swing
クラス ImageIcon

java.lang.Object
  |
  +--javax.swing.ImageIcon

public class ImageIcon
extends Object
implements Icon, Serializable

アイコンをイメージから描画する Icon インタフェースの実装です。URL またはファイル名から作成されるイメージがメディアトラッカーを使ってプリロードされると、イメージのロード状態を監視できます。

警告: このクラスの直列化されたオブジェクトは、今後の Swing リリースと互換ではなくなる予定です。現在の直列化のサポートは、短期間の運用や、同じバージョンの Swing を実行するアプリケーション間の RMI に適しています。今後の Swing リリースでは、長期間の持続性をサポートする予定です。

関連項目:
直列化された形式

フィールドの概要
protected static Component component
           
protected static MediaTracker tracker
           
 
コンストラクタの概要
ImageIcon()
          未初期化イメージアイコンを作成します。
ImageIcon(byte[] imageData)
          サポートされている GIF や JPEG などの、イメージ形式を格納しているイメージファイルから読み出されたバイトデータの並びからイメージアイコンを作成します。
ImageIcon(byte[] imageData, String description)
          サポートされている GIF や JPEG などの、イメージ形式を格納しているイメージファイルから読み出されたバイトデータの並びからイメージアイコンを作成します。
ImageIcon(Image image)
          イメージオブジェクトからイメージアイコンを作成します。
ImageIcon(Image image, String description)
          イメージからイメージを作成します。
ImageIcon(String filename)
          指定されたファイルからイメージアイコンを作成します。
ImageIcon(String filename, String description)
          指定されたファイルからイメージアイコンを作成します。
ImageIcon(URL location)
          指定された URL からイメージアイコンを作成します。
ImageIcon(URL location, String description)
          指定された URL からイメージアイコンを作成します。
 
メソッドの概要
 String getDescription()
          イメージの説明を取得します。
 int getIconHeight()
          アイコンの高さを取得します。
 int getIconWidth()
          アイコンの幅を取得します。
 Image getImage()
          Icon の Image を返します。
 int getImageLoadStatus()
          イメージロード操作の状態を返します。
 ImageObserver getImageObserver()
          イメージのイメージオブザーバを返します。
protected  void loadImage(Image image)
          イメージがロードされるのを待ちます。
 void paintIcon(Component c, Graphics g, int x, int y)
          アイコンを描画します。
 void setDescription(String description)
          イメージの説明を設定します。
 void setImage(Image image)
          アイコンによって表示されるイメージを設定します。
 void setImageObserver(ImageObserver observer)
          イメージのイメージオブザーバを設定します。
 
クラス java.lang.Object から継承したメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

フィールドの詳細

component

protected static final Component component

tracker

protected static final MediaTracker tracker
コンストラクタの詳細

ImageIcon

public ImageIcon(String filename,
                 String description)
指定されたファイルからイメージアイコンを作成します。イメージはメディアトラッカーを使ってプリロードされ、イメージのロード状態を監視します。
パラメータ:
filename - イメージを格納するファイルの名前
description - テキストによるイメージの短い説明
関連項目:
ImageIcon(String)

ImageIcon

public ImageIcon(String filename)
指定されたファイルからイメージアイコンを作成します。イメージはメディアトラッカーを使ってプリロードされ、イメージのロード状態を監視します。指定する文字列はファイル名またはファイルパスです。パスを指定するときは、区切り文字としてインターネット標準のスラッシュ (/) を使います。たとえば、次のように指定します。
    new ImageIcon("images/myImage.gif")
 
(文字列は URL に変換されるので、スラッシュはすべてのシステムで機能します。)
パラメータ:
filename - ファイル名またはパスを指定する文字列

ImageIcon

public ImageIcon(URL location,
                 String description)
指定された URL からイメージアイコンを作成します。イメージはメディアトラッカーを使ってプリロードされ、イメージのロード状態を監視します。
パラメータ:
location - イメージの URL
description - テキストによるイメージの短い説明
関連項目:
ImageIcon(String)

ImageIcon

public ImageIcon(URL location)
指定された URL からイメージアイコンを作成します。イメージはメディアトラッカーを使ってプリロードされ、イメージのロード状態を監視します。

ImageIcon

public ImageIcon(Image image,
                 String description)
イメージからイメージを作成します。
パラメータ:
image - イメージ
description - テキストによるイメージの短い説明

ImageIcon

public ImageIcon(Image image)
イメージオブジェクトからイメージアイコンを作成します。

ImageIcon

public ImageIcon(byte[] imageData,
                 String description)
サポートされている GIF や JPEG などの、イメージ形式を格納しているイメージファイルから読み出されたバイトデータの並びからイメージアイコンを作成します。通常、このバイトデータの並びは Class.getResourceAsStream() を使ったイメージの読み出しによって作成されますが、クラス内に静的にも格納されます。
パラメータ:
imageData - AWT Toolkit によってサポートされる GIF や JPEG などのイメージ形式によるピクセルの並び
description - テキストによるイメージの短い説明
関連項目:
Toolkit.createImage(java.lang.String)

ImageIcon

public ImageIcon(byte[] imageData)
サポートされている GIF や JPEG などの、イメージ形式を格納しているイメージファイルから読み出されたバイトデータの並びからイメージアイコンを作成します。通常、このバイトデータの並びは Class.getResourceAsStream() を使ったイメージの読み出しによって作成されますが、クラス内に静的にも格納されます。
パラメータ:
imageData - AWT Toolkit によってサポートされる GIF や JPEG などのイメージ形式によるピクセルの並び
関連項目:
Toolkit.createImage(java.lang.String)

ImageIcon

public ImageIcon()
未初期化イメージアイコンを作成します。
メソッドの詳細

loadImage

protected void loadImage(Image image)
イメージがロードされるのを待ちます。

getImageLoadStatus

public int getImageLoadStatus()
イメージロード操作の状態を返します。
戻り値:
java.awt.MediaTracker によって定義されるロード状態
関連項目:
MediaTracker.ABORTED, MediaTracker.ERRORED, MediaTracker.COMPLETE

getImage

public Image getImage()
Icon の Image を返します。

setImage

public void setImage(Image image)
アイコンによって表示されるイメージを設定します。

getDescription

public String getDescription()
イメージの説明を取得します。これは、テキストによるオブジェクトの短い説明のことです。たとえば、目の不自由なユーザに対して、イメージの目的を指示するために提示されます。

setDescription

public void setDescription(String description)
イメージの説明を設定します。これは、テキストによるオブジェクトの短い説明のことです。たとえば、目の不自由なユーザに対して、イメージの目的を指示するために提示されます。

paintIcon

public void paintIcon(Component c,
                      Graphics g,
                      int x,
                      int y)
アイコンを描画します。
定義:
インタフェース Icon 内の paintIcon

getIconWidth

public int getIconWidth()
アイコンの幅を取得します。
定義:
インタフェース Icon 内の getIconWidth

getIconHeight

public int getIconHeight()
アイコンの高さを取得します。
定義:
インタフェース Icon 内の getIconHeight

setImageObserver

public void setImageObserver(ImageObserver observer)
イメージのイメージオブザーバを設定します。イメージアイコンが動画 GIF を格納している場合にはこのプロパティを設定するので、オブザーバはその表示を更新するように通知されます。次に例を示します。
     icon = new ImageIcon(...)
     button.setIcon(icon);
     icon.setImageObserver(button);
 

getImageObserver

public ImageObserver getImageObserver()
イメージのイメージオブザーバを返します。

Java プラットフォーム 1.2

バグや機能要求の報告
新しい javadoc の表示についてのコメントやご提案
Java は、米国およびその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-1998 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.