Class java.awt.swing.ImageIcon
java.lang.Object
|
+----java.awt.swing.ImageIcon
- public class ImageIcon
- extends Object
- implements Icon, Serializable
An implementation of the Icon interface that paints Icons
from Images. Images that are created from a URL or filename
are preloaded using MediaTracker to monitor the loaded state
of the image.
Warning: serialized objects of this class will not be compatible with
future swing releases. The current serialization support is appropriate
for short term storage or RMI between Swing1.0 applications. It will
not be possible to load serialized Swing1.0 objects with future releases
of Swing. The JDK1.2 release of Swing will be the compatibility
baseline for the serialized form of Swing objects.
Constructor Summary
|
ImageIcon(String filename,
String description)
Creates an ImageIcon from the specified file.
|
ImageIcon(String filename)
Creates an ImageIcon from the specified file.
|
ImageIcon(URL location,
String description)
Creates an ImageIcon from the specified URL.
|
ImageIcon(URL location)
Creates an ImageIcon from the specified URL.
|
ImageIcon(Image image,
String description)
Creates an ImageIcon from the image.
|
ImageIcon(Image image)
Creates an ImageIcon from the image.
|
ImageIcon(byte[] imageData,
String description)
Creates an ImageIcon from an array of bytes which were
read from an image file containing a supported image format,
such as GIF or JPEG.
|
ImageIcon(byte[] imageData)
Creates an ImageIcon from an array of bytes which were
read from an image file containing a supported image format,
such as GIF or JPEG.
|
ImageIcon()
Creates an uninitialized image icon.
|
Methods inherited from class java.lang.Object
|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
component
protected static final Component component
tracker
protected static final MediaTracker tracker
ImageIcon
public ImageIcon(String filename,
String description)
- Creates an ImageIcon from the specified file. The image will
be preloaded by using MediaTracker to monitor the loading state
of the image.
- Parameters:
filename
- the name of the file containing the image
description
- a brief textual description of the image
ImageIcon
public ImageIcon(String filename)
- Creates an ImageIcon from the specified file. The image will
be preloaded by using MediaTracker to monitor the loading state
of the image.
ImageIcon
public ImageIcon(URL location,
String description)
- Creates an ImageIcon from the specified URL. The image will
be preloaded by using MediaTracker to monitor the loaded state
of the image.
- Parameters:
URL
- the URL for the image
description
- a brief textual description of the image
ImageIcon
public ImageIcon(URL location)
- Creates an ImageIcon from the specified URL. The image will
be preloaded by using MediaTracker to monitor the loaded state
of the image.
ImageIcon
public ImageIcon(Image image,
String description)
- Creates an ImageIcon from the image.
- Parameters:
image
- the image
description
- a brief textual description of the image
ImageIcon
public ImageIcon(Image image)
- Creates an ImageIcon from the image.
ImageIcon
public ImageIcon(byte[] imageData,
String description)
- Creates an ImageIcon from an array of bytes which were
read from an image file containing a supported image format,
such as GIF or JPEG. Normally this array is created
by reading an image using Class.getResourceAsStream(), but
the byte array may also be statically stored in a class.
- Parameters:
imageData
- an array of pixels in an image format supported
by the AWT Toolkit, such as GIF or JPEG.
description
- a brief textual description of the image
- See Also:
- createImage
ImageIcon
public ImageIcon(byte[] imageData)
- Creates an ImageIcon from an array of bytes which were
read from an image file containing a supported image format,
such as GIF or JPEG. Normally this array is created
by reading an image using Class.getResourceAsStream(), but
the byte array may also be statically stored in a class.
- Parameters:
an
- array of pixels in an image format supported by
the AWT Toolkit, such as GIF or JPEG.
- See Also:
- createImage
ImageIcon
public ImageIcon()
- Creates an uninitialized image icon.
loadImage
protected void loadImage(Image image)
- Wait for the image to load
getImageLoadStatus
public int getImageLoadStatus()
- Returns the status of the image loading operation.
- Returns:
- the loading status as defined by java.awt.MediaTracker.
- See Also:
- ABORTED, ERRORED, COMPLETE
getImage
public Image getImage()
- Returns the Icon's Image
setImage
public void setImage(Image image)
- Set the image displayed by this icon.
getDescription
public String getDescription()
- Get the description of the image. This is meant to be a brief
textual description of the object. For example, it might be
presented to a blind user to give an indication of the purpose
of the image.
setDescription
public void setDescription(String description)
- Set the description of the image. This is meant to be a brief
textual description of the object. For example, it might be
presented to a blind user to give an indication of the purpose
of the image.
paintIcon
public void paintIcon(Component c,
Graphics g,
int x,
int y)
- Paints the Icon
- Implements:
- paintIcon in interface Icon
getIconWidth
public int getIconWidth()
- Get the width of the Icon
- Implements:
- getIconWidth in interface Icon
getIconHeight
public int getIconHeight()
- Get the height of the Icon
- Implements:
- getIconHeight in interface Icon
setImageObserver
public void setImageObserver(ImageObserver observer)
- Set the image observer for the image. Set this
property if the ImageIcon contains an animated GIF.
For example:
icon = new ImageIcon(...)
button.setImage(icon);
icon.setImageObserver(button);
getImageObserver
public ImageObserver getImageObserver()
- Return the umage observer for the image
Submit a bug or feature
Submit comments/suggestions about new javadoc look.
Java is a trademark or registered trademark of Sun Microsystems, Inc. in the US and other countries.
Copyright 1993-1998 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California, 94303, U.S.A. All Rights Reserved.