javax.swing
클래스 ImageIcon

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

모든 구현 인터페이스:

Accessible , Icon , Serializable

public class ImageIcon

extends Object

implements Icon , Serializable , Accessible

아이콘을 이미지로부터 표현 하는 Icon 인터페이스의 구현입니다. URL 또는 파일명으로부터 생성되는 이미지가, 로드 상태를 감시하는 메디아트락카를 사용해 프리로드 됩니다.

이미지 아이콘의 상세 및 사용예는 「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

생성자의 개요

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 로부터 이미지 아이콘을 생성합니다.

메소드의 개요

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) 아이콘을 paint 합니다.
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)

지정된 파일로부터 이미지 아이콘을 생성합니다. 이미지는 로드 상태를 감시하는 메디아트락카를 사용해 프리로드 됩니다.

파라미터:

filename - 이미지를 저장하는 파일의 이름

description - 이미지의 짧은 설명 텍스트

관련 항목:

ImageIcon(String)

ImageIcon

public ImageIcon(String  filename)

지정된 파일로부터 이미지 아이콘을 생성합니다. 이미지는 로드 상태를 감시하는 메디아트락카를 사용해 프리로드 됩니다. 지정하는 캐릭터 라인은 파일명 또는 파일 패스입니다. 패스를 지정할 때는 단락 캐릭터로서 인터넷 표준의 slash (/)를 사용합니다. 캐릭터 라인은 URL 에 변환되어 slash는 모든 시스템으로 사용됩니다. 예를 들어 다음과 같이 지정합니다.

new ImageIcon("images/myImage.gif")

설명은 filename 캐릭터 라인에 초기화됩니다.

파라미터:

filename - 파일명 또는 패스를 지정하는 캐릭터 라인

관련 항목:

getDescription()

ImageIcon

public ImageIcon(URL  location,
                 String  description)

지정된 URL 로부터 이미지 아이콘을 생성합니다. 이미지는 로드 상태를 감시하는 메디아트락카를 사용해 프리로드 됩니다.

파라미터:

location - 이미지의 URL

description - 이미지의 짧은 설명 텍스트

관련 항목:

ImageIcon(String)

ImageIcon

public ImageIcon(URL  location)

지정된 URL 로부터 이미지 아이콘을 생성합니다. 이미지는 로드 상태를 감시하는 메디아트락카를 사용해 프리로드 됩니다. 아이콘의 설명은 초기화되어 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 등의, 이미지 형식을 저장하고 있는 이미지 파일로부터 읽어내진 바이트 배열로부터 이미지 아이콘을 생성합니다. 통상, 이 바이트 배열은 Class.getResourceAsStream()를 사용한 이미지의 읽기에 의해 생성됩니다만, 바이트 배열을 클래스내에 정적으로 저장할 수도 있습니다.

파라미터:

imageData - AWT Toolkit 에 의해 서포트되는 GIF 나 JPEG 등의 이미지 형식에 의한 픽셀 배열

description - 이미지의 짧은 설명 텍스트

관련 항목:

Toolkit.createImage(java.lang.String)

ImageIcon

public ImageIcon(byte[] imageData)

서포트되고 있는 GIF 나 JPEG 등의, 이미지 형식을 저장하고 있는 이미지 파일로부터 읽어내진 바이트 배열로부터 이미지 아이콘을 생성합니다. 통상, 이 바이트 배열은 Class.getResourceAsStream()를 사용한 이미지의 읽기에 의해 생성됩니다만, 바이트 배열을 클래스내에 정적으로 저장할 수도 있습니다. 생성된 이미지에 캐릭터 라인의 comment 프로퍼티가 있는 경우, 그 캐릭터 라인은 아이콘의 설명에 사용됩니다.

파라미터:

imageData - AWT Toolkit 에 의해 서포트되는 GIF 나 JPEG 등의 이미지 형식에 의한 픽셀 배열

관련 항목:

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)

아이콘을 paint 합니다. 아이콘의 좌상구석이, 그래픽 문맥 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)

이미지의 이미지 감시 오브젝트를 설정합니다. 이미지 아이콘이 동영상 GIF 를 저장하고 있는 경우에 이 프로퍼티를 설정하면(자), 감시 오브젝트에 대해서 그 표시를 갱신하도록(듯이) 통지됩니다. 다음에 예를 나타냅니다.

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

파라미터:

observer - 이미지 감시 오브젝트

getImageObserver

public ImageObserver  getImageObserver()

이미지의 이미지 감시 오브젝트를 돌려줍니다.

반환값:

이미지 감시 오브젝트. null 의 경우도 있다

toString

public String  toString()

이 이미지의 캐릭터 라인 표현을 돌려줍니다.

오버라이드(override):

클래스 Object 내의 toString

반환값:

이 이미지의 캐릭터 라인 표현

getAccessibleContext

public AccessibleContext  getAccessibleContext()

이 ImageIcon 에 관련지을 수 있었던 AccessibleContext 를 취득합니다. 이미지 아이콘의 경우, AccessibleContext 는 AccessibleImageIcon 의 형식을 취합니다. 필요에 따라서 신규의 AccessibleImageIcon 인스턴스가 생성됩니다.

정의:

인터페이스 Accessible 내의 getAccessibleContext

반환값:

이 ImageIcon 의 AccessibleContext 로서 기능하는 AccessibleImageIcon