public class FileUpload extends FocusWidget implements HasName, HasChangeHandlers, HasEnabled
FormPanel
if it is to
be submitted to a server.
The developer should be aware that most browsers do not allow styling
many properties of the rendered input-file element because of security restrictions.
You can style certain properties like position, visibility, opacity, etc. But size,
color, backgrounds etc. will not work either using css or calling widget methods like setSize().
UIObject.DebugIdImpl, UIObject.DebugIdImplEnabled
DEBUG_ID_PREFIX
Modifier | Constructor and Description |
---|---|
|
FileUpload()
Constructs a new file upload widget.
|
protected |
FileUpload(Element element)
This constructor may be used by subclasses to explicitly use an existing
element.
|
Modifier and Type | Method and Description |
---|---|
HandlerRegistration |
addChangeHandler(ChangeHandler handler)
Adds a
ChangeEvent handler. |
void |
click()
Programmatic equivalent of the user clicking the button, opening
the file selection browser.
|
String |
getFilename()
Gets the filename selected by the user.
|
String |
getName()
Gets the widget's name.
|
boolean |
isEnabled()
Gets whether this widget is enabled.
|
void |
setEnabled(boolean enabled)
Sets whether this widget is enabled.
|
void |
setName(String name)
Sets the widget's name.
|
static FileUpload |
wrap(Element element)
Creates a FileUpload widget that wraps an existing <input
type='file'> element.
|
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, onAttach, removeClickListener, removeFocusListener, removeKeyboardListener, removeMouseListener, removeMouseWheelListener, setAccessKey, setFocus, setTabIndex
addAttachHandler, addBitlessDomHandler, addDomHandler, addHandler, asWidget, asWidgetOrNull, createHandlerManager, delegateEvent, doAttachChildren, doDetachChildren, fireEvent, getHandlerCount, getLayoutData, getParent, isAttached, isOrWasAttached, onBrowserEvent, onDetach, onLoad, onUnload, removeFromParent, setLayoutData, sinkEvents, unsinkEvents
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
fireEvent
public FileUpload()
protected FileUpload(Element element)
element
- the element to be usedpublic static FileUpload wrap(Element element)
RootPanel.detachNow(Widget)
.element
- the element to be wrappedpublic HandlerRegistration addChangeHandler(ChangeHandler handler)
HasChangeHandlers
ChangeEvent
handler.addChangeHandler
in interface HasChangeHandlers
handler
- the change handlerHandlerRegistration
used to remove this handlerpublic String getFilename()
public boolean isEnabled()
isEnabled
in interface HasEnabled
isEnabled
in class FocusWidget
true
if the widget is enabledpublic void setEnabled(boolean enabled)
setEnabled
in interface HasEnabled
setEnabled
in class FocusWidget
enabled
- true
to enable the widget, false
to disable itpublic void setName(String name)
HasName
public void click()
NOTE: in certain browsers programmatic click is disabled if the element display is none, for instance in webkit you have to move the element off screen.
Copyright © 2016. All rights reserved.