IIOWriteWarningListener (Java SE 17 & JDK 17)
Description: declaration: module: java.desktop, package: javax.imageio.event, interface: IIOWriteWarningListener
Keywords: javax.imageio.event.IIOWriteWarningListener interface

Module java.desktop
Package 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

  Modifier and Type
  Method
  Description
  `void`
  `warningOccurred(ImageWriter source, int imageIndex, String warning)`
  Reports the occurrence of a non-fatal error in encoding.

- ## Method Details

  - ### warningOccurred

    void warningOccurred(ImageWriter source, int imageIndex, String warning)
    Reports the occurrence 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.