Interface HasFormSubmitFailedHandlers

All Superinterfaces:
HasHandlers
All Known Implementing Classes:
DynamicForm, PropertySheet, SearchForm

public interface HasFormSubmitFailedHandlers extends HasHandlers
  • 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