ImageIcon
Java SE 6
| public class javax.swing ImageIcon
|
Java SE 6 |
For further information and examples of using image icons, see How to Use Icons in The Java Tutorial.
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 applications running
the same version of Swing. As of 1.4, support for long term storage
of all JavaBeansTM
has been added to the java.beans package.
Please see java.beans.XMLEncoder.
| version | 1.55 04/07/06 |
| Fields | |
|---|---|
| final protected static Component | component |
| final protected static MediaTracker | tracker |
| Constructors | |||||||
|---|---|---|---|---|---|---|---|
| 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.
| ||||||
| 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. The specified String can be a file name or a file path. When specifying a path, use the Internet-standard forward-slash ("/") as a separator. (The string is converted to an URL, so the forward-slash works on all systems.) For example, specify:
new ImageIcon("images/myImage.gif")
The description is initialized to the filename string.
| ||||||
| 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.
| ||||||
| 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. The icon's description is initialized to be a string representation of the URL.
| ||||||
| public | ImageIcon(Image image, String description) Creates an ImageIcon from the image.
| ||||||
| public | ImageIcon(Image image) Creates an ImageIcon from an image object. If the image has a "comment" property that is a string, then the string is used as the description of this icon.
| ||||||
| 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, JPEG, or (as of 1.3) PNG. Normally this array is created by reading an image using Class.getResourceAsStream(), but the byte array may also be statically stored in a class.
| ||||||
| 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, JPEG, or (as of 1.3) PNG. Normally this array is created by reading an image using Class.getResourceAsStream(), but the byte array may also be statically stored in a class. If the resulting image has a "comment" property that is a string, then the string is used as the description of this icon.
| ||||||
| public | ImageIcon() Creates an uninitialized image icon. | ||||||
| Methods | |||||||||
|---|---|---|---|---|---|---|---|---|---|
| protected void | loadImage(Image image) Loads the image, returning only when the image is loaded.
| ||||||||
| public void | paintIcon(Component c, Graphics g, int x, int y) Paints the icon. The top-left corner of the icon is drawn at the point ( x, y)
in the coordinate space of the graphics context g.
If this icon has no image observer,
this method uses the c component
as the observer.
| ||||||||
| public String | toString() Returns a string representation of this image.
| ||||||||
| Properties | |||||||
|---|---|---|---|---|---|---|---|
| public AccessibleContext | getAccessibleContext() Gets the AccessibleContext associated with this ImageIcon. For image icons, the AccessibleContext takes the form of an AccessibleImageIcon. A new AccessibleImageIcon instance is created if necessary.
| ||||||
| public void | setDescription(String description) Sets 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.
| ||||||
| public String | getDescription() Gets 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. The description may be null.
| ||||||
| public int | getIconHeight() Gets the height of the icon.
| ||||||
| public int | getIconWidth() Gets the width of the icon.
| ||||||
| public void | setImage(Image image) Sets the image displayed by this icon.
| ||||||
| public Image | getImage() Returns this icon's Image.
| ||||||
| public int | getImageLoadStatus() Returns the status of the image loading operation.
| ||||||
| public void | setImageObserver(ImageObserver observer) Sets the image observer for the image. Set this property if the ImageIcon contains an animated GIF, so the observer is notified to update its display. For example:
icon = new ImageIcon(...)
button.setIcon(icon);
icon.setImageObserver(button);
| ||||||
| public ImageObserver | getImageObserver() Returns the image observer for the image.
| ||||||
| About DocWeb · Bundles · Export · Export All | Top 10 · Statistics · Login |
| About Sun · Contact · Privacy · Terms of Use · Trademarks | Java SE 6 · Copyright © 1994-2009 Sun Microsystems, Inc.All rights reserved. Use is subject to license terms |
 |
 |
|