com.google.gwt.user.client.ui

## Class SubmitButton

- java.lang.Object
- - com.google.gwt.user.client.ui.UIObject
  - - com.google.gwt.user.client.ui.Widget
    - - com.google.gwt.user.client.ui.FocusWidget
      - - com.google.gwt.user.client.ui.ButtonBase
        - - com.google.gwt.user.client.ui.Button
          - - com.google.gwt.user.client.ui.SubmitButton

All Implemented Interfaces:
  HasAllDragAndDropHandlers, HasAllFocusHandlers, HasAllGestureHandlers, HasAllKeyHandlers, HasAllMouseHandlers, HasAllTouchHandlers, HasBlurHandlers, HasClickHandlers, HasDoubleClickHandlers, HasDragEndHandlers, HasDragEnterHandlers, HasDragHandlers, HasDragLeaveHandlers, HasDragOverHandlers, HasDragStartHandlers, HasDropHandlers, HasFocusHandlers, HasGestureChangeHandlers, HasGestureEndHandlers, HasGestureStartHandlers, HasKeyDownHandlers, HasKeyPressHandlers, HasKeyUpHandlers, HasMouseDownHandlers, HasMouseMoveHandlers, HasMouseOutHandlers, HasMouseOverHandlers, HasMouseUpHandlers, HasMouseWheelHandlers, HasTouchCancelHandlers, HasTouchEndHandlers, HasTouchMoveHandlers, HasTouchStartHandlers, HasAttachHandlers, HasHandlers, HasSafeHtml, EventListener, Focusable, HasEnabled, HasFocus, HasHTML, HasText, HasVisibility, IsWidget, SourcesClickEvents, SourcesFocusEvents, SourcesKeyboardEvents, SourcesMouseEvents

    public class SubmitButton
    extends Button

A standard push-button widget which will automatically submit its enclosing `FormPanel` if any.

### CSS Style Rules

.gwt-SubmitButton
  the outer element

### Nested Class Summary

### Nested classes/interfaces inherited from class com.google.gwt.user.client.ui.UIObject

`UIObject.DebugIdImpl, UIObject.DebugIdImplEnabled`

### Field Summary

### Fields inherited from class com.google.gwt.user.client.ui.Widget

`eventsToSink`

### Fields inherited from class com.google.gwt.user.client.ui.UIObject

`DEBUG_ID_PREFIX, MISSING_ELEMENT_ERROR, SETELEMENT_TWICE_ERROR`

### Constructor Summary

Constructors
`` `SubmitButton()` Creates a button with no caption.
`protected` `SubmitButton(Element element)` This constructor may be used by subclasses to explicitly use an existing element.
`` `SubmitButton(SafeHtml html)` Creates a button with the given HTML caption.
`` `SubmitButton(SafeHtml html, ClickHandler handler)` Creates a button with the given HTML caption and click listener.
`` `SubmitButton(java.lang.String html)` Creates a button with the given HTML caption.
`` `SubmitButton(java.lang.String html, ClickHandler handler)` Creates a button with the given HTML caption and click listener.

### Method Summary

All Methods Static Methods Concrete Methods
`static Button` `wrap(Element element)` Creates a SubmitButton widget that wraps an existing <button> element.

### Methods inherited from class com.google.gwt.user.client.ui.Button

`click, getButtonElement`

### Methods inherited from class com.google.gwt.user.client.ui.ButtonBase

`getHTML, getText, setHTML, setHTML, setText`

### Methods inherited from class com.google.gwt.user.client.ui.FocusWidget

`addBlurHandler, addClickHandler, addClickListener, addDoubleClickHandler, addDragEndHandler, addDragEnterHandler, addDragHandler, addDragLeaveHandler, addDragOverHandler, addDragStartHandler, addDropHandler, addFocusHandler, addFocusListener, addGestureChangeHandler, addGestureEndHandler, addGestureStartHandler, addKeyboardListener, addKeyDownHandler, addKeyPressHandler, addKeyUpHandler, addMouseDownHandler, addMouseListener, addMouseMoveHandler, addMouseOutHandler, addMouseOverHandler, addMouseUpHandler, addMouseWheelHandler, addMouseWheelListener, addTouchCancelHandler, addTouchEndHandler, addTouchMoveHandler, addTouchStartHandler, getFocusImpl, getTabIndex, isEnabled, onAttach, removeClickListener, removeFocusListener, removeKeyboardListener, removeMouseListener, removeMouseWheelListener, setAccessKey, setEnabled, setFocus, setTabIndex`

### Methods inherited from class com.google.gwt.user.client.ui.Widget

`addAttachHandler, addBitlessDomHandler, addDomHandler, addHandler, asWidget, asWidgetOrNull, createHandlerManager, delegateEvent, doAttachChildren, doDetachChildren, ensureHandlers, fireEvent, getHandlerCount, getHandlerManager, getLayoutData, getParent, isAttached, isOrWasAttached, onBrowserEvent, onDetach, onLoad, onUnload, removeFromParent, replaceElement, setLayoutData, setParent, sinkEvents, unsinkEvents`

### Methods inherited from class com.google.gwt.user.client.ui.UIObject

`addStyleDependentName, addStyleName, ensureDebugId, ensureDebugId, ensureDebugId, getAbsoluteLeft, getAbsoluteTop, getElement, getOffsetHeight, getOffsetWidth, getStyleElement, getStyleName, getStyleName, getStylePrimaryName, getStylePrimaryName, getTitle, isVisible, isVisible, onEnsureDebugId, removeStyleDependentName, removeStyleName, resolvePotentialElement, setElement, setElement, setHeight, setPixelSize, setSize, setStyleDependentName, setStyleName, setStyleName, setStyleName, setStyleName, setStylePrimaryName, setStylePrimaryName, setTitle, setVisible, setVisible, setWidth, sinkBitlessEvent, toString`

### Methods inherited from class java.lang.Object

`clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait`

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

`fireEvent`

### Constructor Detail

#### SubmitButton

    public SubmitButton()

Creates a button with no caption.

#### SubmitButton

    public SubmitButton(SafeHtml html)

Creates a button with the given HTML caption.

Parameters:
  `html` - the HTML caption

#### SubmitButton

    public SubmitButton(java.lang.String html)

Creates a button with the given HTML caption.

Parameters:
  `html` - the HTML caption

#### SubmitButton

    public SubmitButton(SafeHtml html,
                        ClickHandler handler)

Creates a button with the given HTML caption and click listener.

Parameters:
  `html` - the HTML caption
  `handler` - the click handler

#### SubmitButton

    public SubmitButton(java.lang.String html,
                        ClickHandler handler)

Creates a button with the given HTML caption and click listener.

Parameters:
  `html` - the HTML caption
  `handler` - the click handler

#### SubmitButton

    protected SubmitButton(Element element)

This constructor may be used by subclasses to explicitly use an existing element. This element must be a <button> element with type submit.

Parameters:
  `element` - the element to be used

### Method Detail

#### wrap

    public static Button wrap(Element element)

Creates a SubmitButton widget that wraps an existing <button> element. This element must already be attached to the document. If the element is removed from the document, you must call `RootPanel.detachNow(Widget)`.

Parameters:
  `element` - the element to be wrapped