ImageIcon (Java Platform SE 7)

java.lang.Object
- javax.swing.ImageIcon

すべての実装されたインタフェース:

Serializable, Accessible, Icon
```
public class ImageIcon
extends Object
implements Icon, Serializable, Accessible
```
アイコンをイメージからペイントする Icon インタフェースの実装です。URL、ファイル名、またはバイト配列から生成されるイメージが、ロード状態を監視する MediaTracker を使ってプリロードされます。
イメージアイコンの詳細および使用例は、「The Java Tutorial」の「How to Use Icons」を参照してください。
警告: このクラスの直列化されたオブジェクトは、今後の Swing リリースと互換ではなくなる予定です。現在の直列化のサポートは、短期間の格納や、同じバージョンの Swing を実行するアプリケーション間の RMI に適しています。1.4 以降、すべての JavaBeans^TM 用の長期間の格納サポートが java.beans パッケージに追加されています。XMLEncoder を参照してください。

ネストされたクラスのサマリー

ネストされたクラス
修飾子と型	クラスと説明
`protected class`	`ImageIcon.AccessibleImageIcon` このクラスは、`ImageIcon` クラスのアクセシビリティーサポートを実装しています。

フィールドのサマリー

フィールド
修飾子と型フィールドと説明

protected static Component component

protected static MediaTracker tracker

フィールド
修飾子と型	フィールドと説明
`protected static Component`	`component`
`protected static MediaTracker`	`tracker`

コンストラクタのサマリー

コンストラクタ
コンストラクタと説明
`ImageIcon()` 初期化されていないイメージアイコンを生成します。
`ImageIcon(byte[] imageData)` サポートされている GIF、JPEG、PNG (1.3 以降) などのイメージ形式を格納しているイメージファイルから読み出されたバイト配列から、イメージアイコンを生成します。
`ImageIcon(byte[] imageData, String description)` サポートされている GIF、JPEG、PNG (1.3 以降) などのイメージ形式を格納しているイメージファイルから読み出されたバイト配列から、イメージアイコンを生成します。
`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 からイメージアイコンを生成します。

メソッドのサマリー

メソッド
修飾子と型	メソッドと説明
`AccessibleContext`	`getAccessibleContext()` この ImageIcon に関連付けられた AccessibleContext を取得します。
`String`	`getDescription()` イメージの説明を取得します。
`int`	`getIconHeight()` アイコンの高さを取得します。
`int`	`getIconWidth()` アイコンの幅を取得します。
`Image`	`getImage()` アイコンの `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)` イメージのイメージ監視オブジェクトを設定します。
`String`	`toString()` このイメージの文字列表現を返します。

クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- フィールドの詳細
  - component
```
protected static final Component component
```
  - tracker
```
protected static final MediaTracker tracker
```
- コンストラクタの詳細
  - ImageIcon
```
public ImageIcon(String filename,
         String description)
```
    指定されたファイルからイメージアイコンを生成します。イメージはロード状態を監視する MediaTracker を使ってプリロードされます。
    
    パラメータ:
    filename - イメージが含まれているファイルの名前
    description - イメージの短い説明テキスト
    関連項目:
    ImageIcon(String)
  - ImageIcon
```
@ConstructorProperties(value="description")
public ImageIcon(String filename)
```
    指定されたファイルからイメージアイコンを生成します。イメージはロード状態を監視する MediaTracker を使ってプリロードされます。指定する文字列はファイル名またはファイルパスです。パスを指定するときは、区切り文字としてインターネット標準のスラッシュ (/) を使います。文字列は URL に変換され、スラッシュはすべてのシステムで使用されます。たとえば次のように指定します。
```
    new ImageIcon("images/myImage.gif") 
```
    説明は、filename 文字列に初期化されます。
    パラメータ:
    filename - ファイル名またはパスを指定する文字列
    関連項目:
    getDescription()
  - ImageIcon
```
public ImageIcon(URL location,
         String description)
```
    指定された URL からイメージアイコンを生成します。イメージはロード状態を監視する MediaTracker を使ってプリロードされます。
    
    パラメータ:
    location - イメージの URL
    description - イメージの短い説明テキスト
    関連項目:
    ImageIcon(String)
  - ImageIcon
```
public ImageIcon(URL location)
```
    指定された URL からイメージアイコンを生成します。イメージはロード状態を監視する MediaTracker を使ってプリロードされます。アイコンの説明は初期化され、URL の文字列表現となります。
    
    パラメータ:
    location - イメージの URL
    関連項目:
    getDescription()
  - ImageIcon
```
public ImageIcon(Image image,
         String description)
```
    イメージからイメージアイコンを生成します。
    
    パラメータ:
    image - イメージ
    description - イメージの短い説明テキスト
  - ImageIcon
```
public ImageIcon(Image image)
```
    イメージオブジェクトからイメージアイコンを生成します。イメージに文字列の comment プロパティーがある場合、その文字列はアイコンの説明に使用されます。
    
    パラメータ:
    image - イメージ
    関連項目:
    getDescription(), Image.getProperty(java.lang.String, java.awt.image.ImageObserver)
  - ImageIcon
```
public ImageIcon(byte[] imageData,
         String description)
```
    サポートされている GIF、JPEG、PNG (1.3 以降) などのイメージ形式を格納しているイメージファイルから読み出されたバイト配列から、イメージアイコンを生成します。通常、このバイト配列は Class.getResourceAsStream() を使ったイメージの読み出しによって生成されますが、バイト配列をクラス内に静的に格納することもできます。
    
    パラメータ:
    imageData - AWT Toolkit によってサポートされる GIF、JPEG、PNG (1.3 以降) などのイメージ形式によるピクセル配列
    description - イメージの短い説明テキスト
    関連項目:
    Toolkit.createImage(java.lang.String)
  - ImageIcon
```
public ImageIcon(byte[] imageData)
```
    サポートされている GIF、JPEG、PNG (1.3 以降) などのイメージ形式を格納しているイメージファイルから読み出されたバイト配列から、イメージアイコンを生成します。通常、このバイト配列は Class.getResourceAsStream() を使ったイメージの読み出しによって生成されますが、バイト配列をクラス内に静的に格納することもできます。結果として得られるイメージに文字列の comment プロパティーがある場合、その文字列はアイコンの説明に使用されます。
    
    パラメータ:
    imageData - AWT Toolkit によってサポートされる GIF、JPEG、PNG (1.3 以降) などのイメージ形式によるピクセル配列
    関連項目:
    Toolkit.createImage(java.lang.String), getDescription(), Image.getProperty(java.lang.String, java.awt.image.ImageObserver)
  - ImageIcon
```
public ImageIcon()
```
    初期化されていないイメージアイコンを生成します。
- メソッドの詳細
  - loadImage
```
protected void loadImage(Image image)
```
    イメージをロードし、イメージがロードされたときのみ復帰します。
    
    パラメータ:
    image - イメージ
  - getImageLoadStatus
```
public int getImageLoadStatus()
```
    イメージロード操作のステータスを返します。
    
    戻り値:
    java.awt.MediaTracker によって定義されるロードステータス
    関連項目:
    MediaTracker.ABORTED, MediaTracker.ERRORED, MediaTracker.COMPLETE
  - getImage
```
public Image getImage()
```
    アイコンの Image を返します。
    
    戻り値:
    この ImageIcon の Image オブジェクト
  - setImage
```
public void setImage(Image image)
```
    アイコンによって表示されるイメージを設定します。
    
    パラメータ:
    image - イメージ
  - getDescription
```
public String getDescription()
```
    イメージの説明を取得します。これは、オブジェクトを説明する短いテキストです。たとえば、目の不自由なユーザーに対して、イメージの目的を示すために使用されます。説明は null でもかまいません。
    
    戻り値:
    イメージの短い説明テキスト
  - setDescription
```
public void setDescription(String description)
```
    イメージの説明を設定します。これは、オブジェクトを説明する短いテキストです。たとえば、目の不自由なユーザーに対して、イメージの目的を示すために使用されます。
    
    パラメータ:
    description - イメージの短い説明テキスト
  - paintIcon
```
public void paintIcon(Component c,
             Graphics g,
             int x,
             int y)
```
    アイコンをペイントします。アイコンの左上隅が、グラフィックコンテキスト g の座標空間にある点 (x, y) に描画されます。このアイコンにイメージ監視オブジェクトがない場合、このメソッドでは監視オブジェクトとして c コンポーネントを使用します。
    
    定義:
    
    paintIcon、インタフェース: Icon
    
    パラメータ:
    c - このアイコンにイメージ監視オブジェクトがない場合に、監視オブジェクトとして使用されるコンポーネント
    g - グラフィックスコンテキスト
    x - アイコンの左上隅の X 座標
    y - アイコンの左上隅の Y 座標
  - getIconWidth
```
public int getIconWidth()
```
    アイコンの幅を取得します。
    
    定義:
    
    getIconWidth、インタフェース: Icon
    
    戻り値:
    このアイコンのピクセル単位の幅
  - getIconHeight
```
public int getIconHeight()
```
    アイコンの高さを取得します。
    
    定義:
    
    getIconHeight、インタフェース: Icon
    
    戻り値:
    このアイコンのピクセル単位の高さ
  - setImageObserver
```
public void setImageObserver(ImageObserver observer)
```
    イメージのイメージ監視オブジェクトを設定します。イメージアイコンが動画 GIF を格納している場合にこのプロパティーを設定すると、監視オブジェクトに対してその表示を更新するように通知されます。例を示します。
```
     icon = new ImageIcon(...)
     button.setIcon(icon);
     icon.setImageObserver(button);
 
```
    パラメータ:
    observer - イメージ監視オブジェクト
  - getImageObserver
```
public ImageObserver getImageObserver()
```
    イメージのイメージ監視オブジェクトを返します。
    
    戻り値:
    イメージ監視オブジェクト。null の場合もある
  - toString
```
public String toString()
```
    このイメージの文字列表現を返します。
    
    オーバーライド:
    
    toString、クラス: Object
    
    戻り値:
    このイメージの文字列表現
  - getAccessibleContext
```
public AccessibleContext getAccessibleContext()
```
    この ImageIcon に関連付けられた AccessibleContext を取得します。イメージアイコンの場合、AccessibleContext は AccessibleImageIcon の形式を取ります。必要に応じて新規の AccessibleImageIcon インスタンスが生成されます。
    
    定義:
    
    getAccessibleContext、インタフェース: Accessible
    
    戻り値:
    この ImageIcon の AccessibleContext として機能する AccessibleImageIcon
    導入されたバージョン:
    
    1.3

バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.

クラス ImageIcon

ネストされたクラスのサマリー

フィールドのサマリー

コンストラクタのサマリー

メソッドのサマリー

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

フィールドの詳細

component

tracker

コンストラクタの詳細

ImageIcon

ImageIcon

ImageIcon

ImageIcon

ImageIcon

ImageIcon

ImageIcon

ImageIcon

ImageIcon

メソッドの詳細

loadImage

getImageLoadStatus

getImage

setImage

getDescription

setDescription

paintIcon

getIconWidth

getIconHeight

setImageObserver

getImageObserver

toString

getAccessibleContext