/* * @(#)IIOWriteWarningListener.java 1.19 03/12/19 * * Copyright 2004 Sun Microsystems, Inc. All rights reserved. * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms. */ package javax.imageio.event; import java.util.EventListener; import javax.imageio.ImageWriter; /** * 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 javax.imageio.ImageWriter#addIIOWriteWarningListener * @see javax.imageio.ImageWriter#removeIIOWriteWarningListener * * @version 0.5 */ public interface IIOWriteWarningListener extends EventListener { /** * 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. * * @param source the ImageWriter object calling this method. * @param imageIndex the index, starting with 0, of the image * generating the warning. * @param warning a String containing the warning. */ void warningOccurred(ImageWriter source, int imageIndex, String warning); }