Package com.smartgwt.client.widgets.form.events

# Interface HasFormSubmitFailedHandlers

All Superinterfaces:
  `HasHandlers`

All Known Implementing Classes:
  `DynamicForm`, `PropertySheet`, `SearchForm`

public interface HasFormSubmitFailedHandlers extends HasHandlers

- ## Method Summary

  Modifier and Type
  Method
  Description
  `HandlerRegistration`
  `addFormSubmitFailedHandler(FormSubmitFailedHandler handler)`
  Method called when an attempt to `natively submit` a form is unable to submit to the server.

  ### Methods inherited from interface com.google.gwt.event.shared.HasHandlers

  `fireEvent`

- ## Method Details

  - ### addFormSubmitFailedHandler

    HandlerRegistration addFormSubmitFailedHandler(FormSubmitFailedHandler handler)
    Method called when an attempt to `natively submit` a form is unable to submit to the server. Default behavior is to display the `formSubmitFailedWarning` in a warning dialog. The most common cause for this failure is that the user has typed an invalid file-path into an upload type field.

    Note: This is very unlikely to occur with modern versions of IE, which don't allow the path of a file to be edited by hand (only selected via file navigation). It was last seen in IE6-7 under Windows XP.

    Rather than throwing an exception on the client during submit(), normally all failures in native form submission are handled by the server. For further information, see `File Uploading`.

    Parameters:
      `handler` - the formSubmitFailed handler
    Returns:
      `HandlerRegistration` used to remove this handler