javax.imageio.event
Interface IIOWriteWarningListener

All Superinterfaces:

EventListener

public interface IIOWriteWarningListener
extends EventListener   

An interface used by ImageWriter implementations to notify callers of their image and thumbnail reading methods of warnings (non-fatal errors). Fatal errors cause the relevant read method to throw an IIOException.

Localization is handled by associating a Locale with each IIOWriteWarningListener as it is registered with an ImageWriter. It is up to the ImageWriter to provide localized messages.

See Also:

ImageWriter.addIIOWriteWarningListener(javax.imageio.event.IIOWriteWarningListener) , ImageWriter.removeIIOWriteWarningListener(javax.imageio.event.IIOWriteWarningListener)

Method Summary

void	warningOccurred (ImageWriter source, int imageIndex, String warning) Reports the occurence of a non-fatal error in encoding.

Method Detail

warningOccurred

void warningOccurred(ImageWriter    source,
                     int imageIndex,
                     String    warning)

Reports the occurence of a non-fatal error in encoding. Encoding will continue following the call to this method. The application may choose to display a dialog, print the warning to the console, ignore the warning, or take any other action it chooses.

Parameters:

source - the ImageWriter object calling this method.

imageIndex - the index, starting with 0, of the image generating the warning.

warning - a String containing the warning.