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 버전 1.4 그 뒤로는 java.beans 패키지로 모든 JavaBeans^™ 장기 기억이 지원 됩니다. XMLEncoder를 참조하십시오.

중첩(Nested) 클래스 개요

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