- java.lang.Object
-
- javax.swing.ImageIcon
-
- All Implemented Interfaces:
- Serializable, Accessible, Icon
public class ImageIcon extends Object implements Icon, Serializable, Accessible
An implementation of the Icon interface that paints Icons from Images. Images that are created from a URL, filename or byte array are preloaded using MediaTracker to monitor the loaded state of the image.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 seeXMLEncoder
.
-
-
Nested Class Summary
Nested Classes Modifier and Type Class and Description protected class
ImageIcon.AccessibleImageIcon
This class implements accessibility support for theImageIcon
class.
-
Field Summary
Fields Modifier and Type Field and Description protected static Component
component
protected static MediaTracker
tracker
-
Constructor Summary
Constructors Constructor and Description ImageIcon()
Creates an uninitialized image icon.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.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.ImageIcon(Image image)
Creates an ImageIcon from an image object.ImageIcon(Image image, String description)
Creates an ImageIcon from the image.ImageIcon(String filename)
Creates an ImageIcon from the specified file.ImageIcon(String filename, String description)
Creates an ImageIcon from the specified file.ImageIcon(URL location)
Creates an ImageIcon from the specified URL.ImageIcon(URL location, String description)
Creates an ImageIcon from the specified URL.
-
Method Summary
Methods Modifier and Type Method and 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'sImage
.int
getImageLoadStatus()
Returns the status of the image loading operation.ImageObserver
getImageObserver()
Returns the image observer for the image.protected void
loadImage(Image image)
Loads the image, returning only when the image is loaded.void
paintIcon(Component c, Graphics g, int x, int y)
Paints the icon.void
setDescription(String description)
Sets the description of the image.void
setImage(Image image)
Sets the image displayed by this icon.void
setImageObserver(ImageObserver observer)
Sets the image observer for the image.String
toString()
Returns a string representation of this image.
-
-
-
Field Detail
-
component
protected static final Component component
-
tracker
protected static final MediaTracker tracker
-
-
Constructor Detail
-
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 imagedescription
- a brief textual description of the image- See Also:
ImageIcon(String)
-
ImageIcon
@ConstructorProperties(value="description") 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 thefilename
string.- Parameters:
filename
- a String specifying a filename or path- See Also:
getDescription()
-
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:
location
- the URL for the imagedescription
- a brief textual description of the image- See Also:
ImageIcon(String)
-
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. The icon's description is initialized to be a string representation of the URL.- Parameters:
location
- the URL for the image- See Also:
getDescription()
-
ImageIcon
public ImageIcon(Image image, String description)
Creates an ImageIcon from the image.- Parameters:
image
- the imagedescription
- a brief textual description of the image
-
ImageIcon
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.- Parameters:
image
- the image- See Also:
getDescription()
,Image.getProperty(java.lang.String, java.awt.image.ImageObserver)
-
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, 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.- Parameters:
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 image- See Also:
Toolkit.createImage(java.lang.String)
-
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, 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.- Parameters:
imageData
- an array of pixels in an image format supported by the AWT Toolkit, such as GIF, JPEG, or (as of 1.3) PNG- See Also:
Toolkit.createImage(java.lang.String)
,getDescription()
,Image.getProperty(java.lang.String, java.awt.image.ImageObserver)
-
ImageIcon
public ImageIcon()
Creates an uninitialized image icon.
-
-
Method Detail
-
loadImage
protected void loadImage(Image image)
Loads the image, returning only when the image is loaded.- Parameters:
image
- the image
-
getImageLoadStatus
public int getImageLoadStatus()
Returns the status of the image loading operation.- Returns:
- the loading status as defined by java.awt.MediaTracker
- See Also:
MediaTracker.ABORTED
,MediaTracker.ERRORED
,MediaTracker.COMPLETE
-
getImage
public Image getImage()
Returns this icon'sImage
.- Returns:
- the
Image
object for thisImageIcon
-
setImage
public void setImage(Image image)
Sets the image displayed by this icon.- Parameters:
image
- the image
-
getDescription
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.- Returns:
- a brief textual description of the image
-
setDescription
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.- Parameters:
description
- a brief textual description of the image
-
paintIcon
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 contextg
. If this icon has no image observer, this method uses thec
component as the observer.
-
getIconWidth
public int getIconWidth()
Gets the width of the icon.- Specified by:
getIconWidth
in interfaceIcon
- Returns:
- the width in pixels of this icon
-
getIconHeight
public int getIconHeight()
Gets the height of the icon.- Specified by:
getIconHeight
in interfaceIcon
- Returns:
- the height in pixels of this icon
-
setImageObserver
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);
- Parameters:
observer
- the image observer
-
getImageObserver
public ImageObserver getImageObserver()
Returns the image observer for the image.- Returns:
- the image observer, which may be null
-
toString
public String toString()
Returns a string representation of this image.
-
getAccessibleContext
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.- Specified by:
getAccessibleContext
in interfaceAccessible
- Returns:
- an AccessibleImageIcon that serves as the AccessibleContext of this ImageIcon
- Since:
- 1.3
-
-
Deutsche Übersetzung
Sie haben gebeten, diese Seite auf Deutsch zu besuchen. Momentan ist nur die Oberfläche übersetzt, aber noch nicht der gesamte Inhalt.Wenn Sie mir bei Übersetzungen helfen wollen, ist Ihr Beitrag willkommen. Alles, was Sie tun müssen, ist, sich auf der Website zu registrieren und mir eine Nachricht zu schicken, in der Sie gebeten werden, Sie der Gruppe der Übersetzer hinzuzufügen, die Ihnen die Möglichkeit gibt, die gewünschten Seiten zu übersetzen. Ein Link am Ende jeder übersetzten Seite zeigt an, dass Sie der Übersetzer sind und einen Link zu Ihrem Profil haben.
Vielen Dank im Voraus.
Dokument erstellt 11/06/2005, zuletzt geändert 04/03/2020
Quelle des gedruckten Dokuments:https://www.gaudry.be/de/java-api-rf-javax/swing/ImageIcon.html
Die Infobro ist eine persönliche Seite, deren Inhalt in meiner alleinigen Verantwortung liegt. Der Text ist unter der CreativeCommons-Lizenz (BY-NC-SA) verfügbar. Weitere Informationen auf die Nutzungsbedingungen und dem Autor.
Referenzen
Diese Verweise und Links verweisen auf Dokumente, die während des Schreibens dieser Seite konsultiert wurden, oder die zusätzliche Informationen liefern können, aber die Autoren dieser Quellen können nicht für den Inhalt dieser Seite verantwortlich gemacht werden.
Der Autor Diese Website ist allein dafür verantwortlich, wie die verschiedenen Konzepte und Freiheiten, die mit den Nachschlagewerken gemacht werden, hier dargestellt werden. Denken Sie daran, dass Sie mehrere Quellinformationen austauschen müssen, um das Risiko von Fehlern zu reduzieren.