javax.swing
類別 ImageIcon

java.lang.Object
  javax.swing.ImageIcon

所有已實作的介面：

Serializable, Accessible, Icon

public class ImageIcon
extends Object
implements Icon, Serializable, Accessible

一個 Icon 介面的實作，它根據 Image 繪製 Icon。可使用 MediaTracker 預載根據 URL、檔案名或位元組陣列創建的圖像，以監視該圖像的載入狀態。

有關使用圖像圖標的更多資訊和範例，請參閱 The Java Tutorial 中的 How to Use Icons 一節。

警告：此類別的序列化物件與以後的 Swing 版本不相容。當前序列化支持適用於短期存儲，或適用於在運行相同 Swing 版本的應用程序之間進行 RMI（Remote Method Invocation，遠端方法調用）。從 1.4 版本開始，已在 java.beans 套件中添加了支持所有 JavaBeans^TM 長期存儲的功能。請參見 XMLEncoder。

巢狀類別摘要

protected class

ImageIcon.AccessibleImageIcon 此類別實作 ImageIcon 類別的可存取性支持。

欄位摘要

protected static Component	component
protected static MediaTracker	tracker

建構子摘要

ImageIcon()
創建一個未初始化的圖像圖標。

ImageIcon(byte[] imageData)
根據位元組陣列創建一個 ImageIcon，這些位元組讀取自一個套件含受支持圖像格式（比如 GIF、JPEG 或從 1.3 版本開始的 PNG）的圖像檔案。

ImageIcon(byte[] imageData, String description)
根據位元組陣列創建一個 ImageIcon，這些位元組讀取自一個套件含受支持圖像格式（比如 GIF、JPEG 或從 1.3 版本開始的 PNG）的圖像檔案。

ImageIcon(Image image)
根據圖像物件創建一個 ImageIcon。

ImageIcon(Image image, String description)
根據圖像創建一個 ImageIcon。

ImageIcon(String filename)
根據指定的檔案創建一個 ImageIcon。

ImageIcon(String filename, String description)
根據指定的檔案創建一個 ImageIcon。

ImageIcon(URL location)
根據指定的 URL 創建一個 ImageIcon。

ImageIcon(URL location, String description)
根據指定的 URL 創建一個 ImageIcon。

方法摘要

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)

根據指定的檔案創建一個 ImageIcon。使用 MediaTracker 預載圖像以監視圖像的載入狀態。

參數：

filename - 套件含圖像的檔案的名稱

description - 圖像的簡明文本描述

另請參見：

ImageIcon(String)

ImageIcon

public ImageIcon(String filename)

根據指定的檔案創建一個 ImageIcon。使用 MediaTracker 預載圖像以監視圖像的載入狀態。指定 String 可以是一個檔案名或是一條檔案路徑。在指定一條路徑時，可使用 Internet 標準正斜槓 ("/") 作為分隔符。（該字元串被轉換成一個 URL，而正斜槓適用於所有系統。）例如，指定：

    new ImageIcon("images/myImage.gif") 

該描述被初始化為 filename 字元串。

參數：

filename - 指定檔案名或路徑的 String

另請參見：

getDescription()

ImageIcon

public ImageIcon(URL location,
                 String description)

根據指定的 URL 創建一個 ImageIcon。使用 MediaTracker 預載圖像以監視圖像的載入狀態。

參數：

location - 圖像的 URL

description - 圖像的簡明文本描述

另請參見：

ImageIcon(String)

ImageIcon

public ImageIcon(URL location)

根據指定的 URL 創建一個 ImageIcon。使用 MediaTracker 預載圖像以監視圖像的載入狀態。圖標的描述被初始化為 URL 的字元串表示形式。

參數：

location - 圖像的 URL

另請參見：

getDescription()

ImageIcon

public ImageIcon(Image image,
                 String description)

根據圖像創建一個 ImageIcon。

參數：

image - 圖像

description - 圖像的簡明文本描述

ImageIcon

public ImageIcon(Image image)

根據圖像物件創建一個 ImageIcon。如果圖像有一個字元串形式的 "comment" 屬性，則該字元串被用作此圖標的描述。

參數：

image - 圖像

另請參見：

getDescription(), Image.getProperty(java.lang.String, java.awt.image.ImageObserver)

ImageIcon

public ImageIcon(byte[] imageData,
                 String description)

根據位元組陣列創建一個 ImageIcon，這些位元組讀取自一個套件含受支持圖像格式（比如 GIF、JPEG 或從 1.3 版本開始的 PNG）的圖像檔案。通常，此陣列是通過使用 Class.getResourceAsStream() 讀取圖像檔案來創建的，但該位元組陣列也可以靜態地存儲在某個類別中。

參數：

imageData - 一個像素陣列，具有受 AWT Toolkit 支持的圖像格式，比如 GIF、JPEG 或從 1.3 版本開始的 PNG

description - 圖像的簡明文本描述

另請參見：

Toolkit.createImage(java.lang.String)

ImageIcon

public ImageIcon(byte[] imageData)

根據位元組陣列創建一個 ImageIcon，這些位元組讀取自一個套件含受支持圖像格式（比如 GIF、JPEG 或從 1.3 版本開始的 PNG）的圖像檔案。通常，此陣列是通過使用 Class.getResourceAsStream() 讀取一幅圖像來創建的，但該位元組陣列也可以靜態地存儲在某個類別中。如果得到的圖像有一個字元串形式的 "comment" 屬性，則該字元串被用作此圖標的描述。

參數：

imageData - 一個像素陣列，具有受 AWT Toolkit 支持的圖像格式，比如 GIF、JPEG 或從 1.3 版本開始的 PNG

另請參見：

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 元件作為觀察者。

指定者：

介面 Icon 中的 paintIcon

參數：

c - 用作觀察者的元件，如果此圖標沒有圖像觀察者

g - 圖形上下文

x - 圖標左上角的 X 坐標

y - 圖標左上角的 Y 坐標

getIconWidth

public int getIconWidth()

獲得圖標的寬度。

指定者：

介面 Icon 中的 getIconWidth

返回：

此圖標的寬度，以像素為單位

getIconHeight

public int getIconHeight()

獲得圖標的高度。

指定者：

介面 Icon 中的 getIconHeight

返回：

此圖標的高度，以像素為單位

setImageObserver

public void setImageObserver(ImageObserver observer)

設置圖像的圖像觀察者。如果 ImageIcon 套件含一個動畫 GIF，則設置此屬性，而觀察者獲得更新其顯示的通知。例如：

     icon = new ImageIcon(...)
     button.setIcon(icon);
     icon.setImageObserver(button);
 

參數：

observer - 圖像觀察者

getImageObserver

public ImageObserver getImageObserver()

返回圖像的圖像觀察者。

返回：

圖像觀察者，它可以為 null

toString

public String toString()

返回此圖像的字元串表示形式。

覆寫：

類別 Object 中的 toString

返回：

表示此圖像的字元串

getAccessibleContext

public AccessibleContext getAccessibleContext()

獲得與此 ImageIcon 關聯的 AccessibleContext。對於圖像圖標，AccessibleContext 採用 AccessibleImageIcon 的形式。如有必要，可創建一個新的 AccessibleImageIcon 實例。

指定者：

介面 Accessible 中的 getAccessibleContext

返回：

一個 AccessibleImageIcon，它將充當此 ImageIcon 的 AccessibleContext

從以下版本開始：

1.3