- /*
- * @(#)IIOWriteWarningListener.java 1.18 03/01/23
- *
- * Copyright 2003 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 <code>ImageWriter</code> 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 <code>IIOException</code>.
- *
- * <p> Localization is handled by associating a <code>Locale</code>
- * with each <code>IIOWriteWarningListener</code> as it is registered
- * with an <code>ImageWriter</code>. It is up to the
- * <code>ImageWriter</code> 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 <code>ImageWriter</code> object calling this method.
- * @param imageIndex the index, starting with 0, of the image
- * generating the warning.
- * @param warning a <code>String</code> containing the warning.
- */
- void warningOccurred(ImageWriter source,
- int imageIndex,
- String warning);
- }