javax.swing

Class ImageIcon

public class ImageIcon extends Object implements Icon, Serializable, Accessible

An {@link Icon} implementation that is backed by an {@link Image}.

Nested Class Summary
protected class	ImageIcon.AccessibleImageIcon Provides the accessibility features for the `ImageIcon` class.

Field Summary
protected static Component	component A dummy Component that is used in the MediaTracker.
protected static MediaTracker	tracker The MediaTracker used to monitor the loading of images.

Constructor Summary
	ImageIcon() Creates an ImageIcon without any properties set.
	ImageIcon(String filename) Constructs an ImageIcon given a filename.
	ImageIcon(String filename, String description) Constructs an ImageIcon from the given filename, setting its description to the given description.
	ImageIcon(byte[] imageData) Creates an ImageIcon from the given byte array without any description set.
	ImageIcon(byte[] imageData, String description) Creates an ImageIcon from the given byte array and sets the given description.
	ImageIcon(URL url) Creates an ImageIcon from the given URL and sets the description to the URL String representation.
	ImageIcon(URL url, String description) Creates an ImageIcon from the given URL and sets the given description.
	ImageIcon(Image image) Creates an ImageIcon from the given Image without any description set.
	ImageIcon(Image image, String description) Creates an ImageIcon from the given Image and sets the given description.

Method Summary
AccessibleContext	getAccessibleContext() Returns the object that provides accessibility features for this `ImageIcon` instance.
String	getDescription() Returns a human readable description for this ImageIcon or null when no description is set or available.
int	getIconHeight() Returns the the height of the backing Image, or -1 if the backing Image is null.
int	getIconWidth() Returns the the width of the backing Image, or -1 if the backing Image is null.
Image	getImage() Returns the backing Image for this ImageIcon.
int	getImageLoadStatus() Returns the load status of the icon image.
ImageObserver	getImageObserver() Returns the ImageObserver that is used for all Image operations.
protected void	loadImage(Image image) Loads the image and blocks until the loading operation is finished.
void	paintIcon(Component c, Graphics g, int x, int y) Calls `g.drawImage()` on the backing Image using the set observer of this ImageIcon.
void	setDescription(String description) Sets a human readable description for this ImageIcon.
void	setImage(Image image) Explicitly sets the backing Image for this ImageIcon.
void	setImageObserver(ImageObserver newObserver) Sets the ImageObserver that will be used for all Image operations.

Field Detail

component

protected static final Component component

A dummy Component that is used in the MediaTracker.

tracker

protected static final MediaTracker tracker

The MediaTracker used to monitor the loading of images.

Constructor Detail

ImageIcon

public ImageIcon()

Creates an ImageIcon without any properties set.

ImageIcon

public ImageIcon(String filename)

Constructs an ImageIcon given a filename. The icon's description is initially set to the filename itself. A filename of "" means create a blank icon.

Parameters: filename name of file to load or "" for a blank icon

ImageIcon

public ImageIcon(String filename, String description)

Constructs an ImageIcon from the given filename, setting its description to the given description. A filename of "" means create a blank icon.

Parameters: filename name of file to load or "" for a blank icon description human-readable description of this icon

ImageIcon

public ImageIcon(byte[] imageData)

Creates an ImageIcon from the given byte array without any description set.

ImageIcon

public ImageIcon(byte[] imageData, String description)

Creates an ImageIcon from the given byte array and sets the given description.

ImageIcon

public ImageIcon(URL url)

Creates an ImageIcon from the given URL and sets the description to the URL String representation.

ImageIcon

public ImageIcon(URL url, String description)

Creates an ImageIcon from the given URL and sets the given description.

ImageIcon

public ImageIcon(Image image)

Creates an ImageIcon from the given Image without any description set.

ImageIcon

public ImageIcon(Image image, String description)

Creates an ImageIcon from the given Image and sets the given description.

Method Detail

getAccessibleContext

public AccessibleContext getAccessibleContext()

Returns the object that provides accessibility features for this ImageIcon instance.

Returns: The accessible context (an instance of {@link AccessibleImageIcon}).

getDescription

public String getDescription()

Returns a human readable description for this ImageIcon or null when no description is set or available.

getIconHeight

public int getIconHeight()

Returns the the height of the backing Image, or -1 if the backing Image is null. The getHeight() method of the Image will be called with the set observer of this ImageIcon.

getIconWidth

public int getIconWidth()

Returns the the width of the backing Image, or -1 if the backing Image is null. The getWidth() method of the Image will be called with the set observer of this ImageIcon.