Serializable
, Accessible
, Icon
public class ImageIcon extends Object implements Icon, Serializable, Accessible
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 JavaBeans has been added to the java.beans
package. Please see XMLEncoder
.
Modifier and Type | Class | Description |
---|---|---|
protected class |
ImageIcon.AccessibleImageIcon |
This class implements accessibility support for the ImageIcon class. |
Modifier and Type | Field | Description |
---|---|---|
protected static final Component |
component |
Deprecated. since 1.8 |
protected static final MediaTracker |
tracker |
Deprecated. since 1.8 |
Constructor | Description |
---|---|
ImageIcon() |
Creates an uninitialized image icon. |
ImageIcon |
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. |
ImageIcon |
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. |
ImageIcon |
Creates an ImageIcon from an image object. |
ImageIcon |
Creates an ImageIcon from the image. |
ImageIcon |
Creates an ImageIcon from the specified file. |
ImageIcon |
Creates an ImageIcon from the specified file. |
ImageIcon |
Creates an ImageIcon from the specified URL. |
ImageIcon |
Creates an ImageIcon from the specified URL. |
Modifier and Type | Method | Description |
---|---|---|
AccessibleContext |
getAccessibleContext() |
Gets the AccessibleContext associated with this ImageIcon. |
String |
getDescription() |
Gets the description of the image. |
int |
getIconHeight() |
Gets the height of the icon. |
int |
getIconWidth() |
Gets the width of the icon. |
Image |
getImage() |
Returns this icon's Image . |
int |
getImageLoadStatus() |
Returns the status of the image loading operation. |
ImageObserver |
getImageObserver() |
Returns the image observer for the image. |
protected void |
loadImage |
Loads the image, returning only when the image is loaded. |
void |
paintIcon |
Paints the icon. |
void |
setDescription |
Sets the description of the image. |
void |
setImage |
Sets the image displayed by this icon. |
void |
setImageObserver |
Sets the image observer for the image. |
String |
toString() |
Returns a string representation of this image. |
@Deprecated protected static final Component component
@Deprecated protected static final MediaTracker tracker
public ImageIcon(String filename, String description)
filename
- the name of the file containing the imagedescription
- a brief textual description of the image@ConstructorProperties("description") public ImageIcon(String filename)
new ImageIcon("images/myImage.gif")The description is initialized to the
filename
string.filename
- a String specifying a filename or pathpublic ImageIcon(URL location, String description)
location
- the URL for the imagedescription
- a brief textual description of the imagepublic ImageIcon(URL location)
location
- the URL for the imagepublic ImageIcon(Image image, String description)
image
- the imagedescription
- a brief textual description of the imagepublic ImageIcon(Image image)
image
- the imagepublic ImageIcon(byte[] imageData, String description)
imageData
- an array of pixels in an image format supported by the AWT Toolkit, such as GIF, JPEG, or (as of 1.3) PNGdescription
- a brief textual description of the imagepublic ImageIcon(byte[] imageData)
imageData
- an array of pixels in an image format supported by the AWT Toolkit, such as GIF, JPEG, or (as of 1.3) PNGpublic ImageIcon()
protected void loadImage(Image image)
image
- the imagepublic int getImageLoadStatus()
public Image getImage()
Image
.Image
object for this ImageIcon
public void setImage(Image image)
image
- the imagepublic String getDescription()
public void setDescription(String description)
description
- a brief textual description of the imagepublic void paintIcon(Component c, Graphics g, int x, int y)
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 int getIconWidth()
getIconWidth
in interface Icon
public int getIconHeight()
getIconHeight
in interface Icon
public void setImageObserver(ImageObserver observer)
icon = new ImageIcon(...) button.setIcon(icon); icon.setImageObserver(button);
observer
- the image observerpublic ImageObserver getImageObserver()
public String toString()
@BeanProperty(expert=true, description="The AccessibleContext associated with this ImageIcon.") public AccessibleContext getAccessibleContext()
getAccessibleContext
in interface Accessible
© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.desktop/javax/swing/ImageIcon.html