ImageIcon — 이미지 아이콘

ImageIcon — 이미지 아이콘

ImageIcon은 이미지로부터 아이콘을 그리는 Icon 인터페이스의 구현입니다. URL·파일명·바이트 배열로부터 만든 이미지를 MediaTracker로 미리 로드합니다.

출처: Java API Reference

본문

public class ImageIcon extends Object implements Icon, Serializable, Accessible

이미지에서 아이콘을 그리는 Icon 인터페이스의 구현입니다. URL, 파일명 또는 바이트 배열로 만든 이미지는 MediaTracker를 사용해 이미지의 로드 상태를 모니터링하도록 미리 로드합니다. 이미지 아이콘 사용에 대한 자세한 내용과 예는 The Java Tutorial의 "How to Use Icons"를 참고하세요. 이 클래스의 직렬화된 객체는 향후 Swing 버전과 호환되지 않을 수 있습니다. 현재 직렬화 지원은 단기 저장이나 같은 버전의 Swing을 실행하는 애플리케이션 간 RMI에 적합합니다. 1.4부터 모든 JavaBean의 장기 저장 지원이 java.beans 패키지에 추가되었으니 XMLEncoder를 참고하세요.

ImageIcon

public ImageIcon(String filename)

지정된 파일에서 ImageIcon을 생성합니다. 이미지는 MediaTracker로 로드 상태를 모니터링하며 미리 로드됩니다. 지정된 String은 파일 이름이나 파일 경로가 될 수 있습니다. 경로를 지정할 때는 인터넷 표준인 슬래시("/")를 구분자로 사용하세요. (문자열이 URL로 변환되므로 슬래시는 모든 시스템에서 동작합니다.) 예: 지정 new ImageIcon("images/myImage.gif"). 설명은 파일 이름 문자열로 초기화됩니다.

  • 매개변수: filename - 파일 이름이나 경로를 지정하는 String

ImageIcon

public ImageIcon(String filename, String description)

지정된 파일에서 ImageIcon을 생성합니다. 이미지는 MediaTracker로 로드 상태를 모니터링하며 미리 로드됩니다.

  • 매개변수: filename - 이미지를 담은 파일의 이름
  • 매개변수: description - 이미지의 짧은 텍스트 설명

ImageIcon

public ImageIcon(URL location)

지정된 URL에서 ImageIcon을 생성합니다. 이미지는 MediaTracker로 로드 상태를 모니터링하며 미리 로드됩니다. 아이콘의 설명은 URL의 문자열 표현으로 초기화됩니다.

  • 매개변수: location - 이미지의 URL

ImageIcon

public ImageIcon(Image image)

이미지 객체에서 ImageIcon을 생성합니다. 이미지가 문자열인 "comment" 프로퍼티를 가지면 그 문자열이 이 아이콘의 설명으로 사용됩니다.

  • 매개변수: image - 이미지

ImageIcon

public ImageIcon(Image image, String description)

이미지에서 ImageIcon을 생성합니다.

  • 매개변수: image - 이미지
  • 매개변수: description - 이미지의 짧은 텍스트 설명

ImageIcon

public ImageIcon(byte[] imageData)

GIF, JPEG 또는 (1.3부터) PNG 같은 지원되는 이미지 형식의 이미지 파일에서 읽은 바이트 배열로 ImageIcon을 생성합니다. 보통 이 배열은 Class.getResourceAsStream()으로 이미지를 읽어 만드는데, 바이트 배열은 클래스에 정적으로 저장될 수도 있습니다. 결과 이미지가 문자열인 "comment" 프로퍼티를 가지면 그 문자열이 이 아이콘의 설명으로 사용됩니다.

  • 매개변수: imageData - AWT Toolkit이 지원하는 이미지 형식(GIF, JPEG, (1.3부터) PNG 등)의 픽셀 배열

ImageIcon

public ImageIcon(byte[] imageData, String description)

GIF, JPEG 또는 (1.3부터) PNG 같은 지원되는 이미지 형식의 이미지 파일에서 읽은 바이트 배열로 ImageIcon을 생성합니다. 보통 이 배열은 Class.getResourceAsStream()으로 이미지를 읽어 만들지만, 바이트 배열은 클래스에 정적으로 저장될 수도 있습니다.

  • 매개변수: imageData - AWT Toolkit이 지원하는 이미지 형식의 픽셀 배열
  • 매개변수: description - 이미지의 짧은 텍스트 설명

ImageIcon

public ImageIcon()

초기화되지 않은 이미지 아이콘을 생성합니다.

loadImage

protected void loadImage(Image image)

이미지를 로드하며, 이미지가 로드될 때까지 반환하지 않습니다.

  • 매개변수: image - 이미지

getImageLoadStatus

public int getImageLoadStatus()

이미지 로드 작업의 상태를 반환합니다.

  • 반환값: java.awt.MediaTracker가 정의하는 로드 상태

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 컴포넌트를 관찰자로 사용합니다.

  • 매개변수: c - 이 아이콘에 이미지 관찰자가 없을 때 관찰자로 사용할 컴포넌트
  • 매개변수: g - 그래픽 컨텍스트
  • 매개변수: x - 아이콘 왼쪽 위 모서리의 X 좌표
  • 매개변수: y - 아이콘 왼쪽 위 모서리의 Y 좌표

getIconWidth

public int getIconWidth()

아이콘의 너비를 가져옵니다.

  • 반환값: 이 아이콘의 픽셀 너비

getIconHeight

public int 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

@BeanProperty(expert=true, description="The AccessibleContext associated with this ImageIcon.") public AccessibleContext getAccessibleContext()

이 ImageIcon과 연관된 AccessibleContext를 가져옵니다. 이미지 아이콘의 경우 AccessibleContext는 AccessibleImageIcon의 형태를 취합니다. 필요한 경우 새 AccessibleImageIcon 인스턴스가 생성됩니다.

  • 반환값: 이 ImageIcon의 AccessibleContext 역할을 하는 AccessibleImageIcon
  • 버전: 1.3

더 알아보기