javax.swing
클래스 ImageIcon

java.lang.Object 
  javax.swing.ImageIcon

모든 구현된 인터페이스:

Serializable , Accessible , Icon

public class ImageIcon
extends Object 
implements Icon , Serializable , Accessible 

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

이미지 아이콘의 상세 및 사용예는, 「The Java Tutorial」의 「How to Use Icons」를 참조해 주세요.

경고: 이 클래스의 직렬화 된 객체는, 향후의 Swing 릴리스와 호환은 아니게 될 예정입니다. 현재의 직렬화의 지원는, 단기간의 운용이나, 같은 버젼의 Swing 를 실행하는 어플리케이션간의 RMI 에 적절하고 있습니다. JDK Version 1.4 이후, 모든 JavaBeans^™ 의 장기간의 운용 지원는,java.beans 패키지에 추가되고 있습니다. 자세한 것은,XMLEncoder 를 참조해 주세요.

상자의 클래스의 개요

protected class

ImageIcon.AccessibleImageIcon 이 클래스는 ImageIcon 클래스용의 접근성? 지원를 구현하고 있습니다.

필드의 개요

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)

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

파라미터:

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, 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)에 draw 됩니다. 이 아이콘에 이미지 감시 객체가 없는 경우, 이 메소드에서는 감시 객체로서 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

도입된 버젼:

1.3