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

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