com.smartgwt.client.widgets.form.events

## Interface HasFormSubmitFailedHandlers

- All Superinterfaces:
    com.google.gwt.event.shared.HasHandlers
  All Known Implementing Classes:
    DynamicForm, PropertySheet, SearchForm

      public interface HasFormSubmitFailedHandlers
      extends com.google.gwt.event.shared.HasHandlers

- - ### Method Summary

    All Methods Instance Methods Abstract Methods
    Modifier and Type | Method and Description
    --- | ---
    `com.google.gwt.event.shared.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 Detail

    - #### addFormSubmitFailedHandler

          com.google.gwt.event.shared.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