javax.imageio.event
Interface IIOWriteWarningListener

All Superinterfaces:

java.util.EventListener

public interface IIOWriteWarningListener

extends java.util.EventListener

An interface used by ImageWriter implementations to notify callers of their image 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, java.lang.String warning) Reports the occurence of a non-fatal error in encoding.

Method Detail

warningOccurred

public void warningOccurred(ImageWriter source,
                            int imageIndex,
                            java.lang.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.