org.vectomatic.file

Class FileUploadExt

java.lang.Object

com.google.gwt.user.client.ui.UIObject

com.google.gwt.user.client.ui.Widget

org.vectomatic.file.FileUploadExt

All Implemented Interfaces:

com.google.gwt.event.dom.client.HasChangeHandlers, com.google.gwt.event.logical.shared.HasAttachHandlers, com.google.gwt.event.shared.HasHandlers, com.google.gwt.user.client.EventListener, com.google.gwt.user.client.ui.HasEnabled, com.google.gwt.user.client.ui.HasName, com.google.gwt.user.client.ui.HasVisibility, com.google.gwt.user.client.ui.IsWidget

public class FileUploadExt
extends com.google.gwt.user.client.ui.Widget
implements com.google.gwt.user.client.ui.HasName, com.google.gwt.event.dom.client.HasChangeHandlers, com.google.gwt.user.client.ui.HasEnabled

FileUpload widget with support for multiple files.

Author:

laaglu

Nested Class Summary

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

com.google.gwt.user.client.ui.UIObject.DebugIdImpl, com.google.gwt.user.client.ui.UIObject.DebugIdImplEnabled

Field Summary

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

DEBUG_ID_PREFIX

Constructor Summary

Constructors

Modifier	Constructor and Description
	FileUploadExt() Constructor.
	FileUploadExt(boolean multiple) Constructor.
protected	FileUploadExt(com.google.gwt.dom.client.Element element, boolean multiple)

Method Summary

Modifier and Type	Method and Description
com.google.gwt.event.shared.HandlerRegistration	addChangeHandler(com.google.gwt.event.dom.client.ChangeHandler handler)
void	click() Shows the file selection box.
String	getFilename() Gets the filename selected by the user.
FileList	getFiles() Returns the files selected by the end-user.
String	getName()
boolean	isEnabled() Gets whether this widget is enabled.
boolean	isMultiple() Returns true if support for multiple file upload is activated, false otherwise.
void	onBrowserEvent(com.google.gwt.user.client.Event event)
void	setEnabled(boolean enabled) Sets whether this widget is enabled.
void	setMultiple(boolean value) Sets support for multiple file upload.
void	setName(String name)
static FileUploadExt	wrap(com.google.gwt.dom.client.Element element, boolean multiple) Creates a FileUploadExt widget that wraps an existing <input type='file'> element.

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

addAttachHandler, addBitlessDomHandler, addDomHandler, addHandler, asWidget, asWidgetOrNull, createHandlerManager, delegateEvent, doAttachChildren, doDetachChildren, fireEvent, getHandlerCount, getLayoutData, getParent, isAttached, isOrWasAttached, onAttach, onDetach, onLoad, onUnload, removeFromParent, setLayoutData, 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

FileUploadExt

public FileUploadExt()

Constructor. This constructors creates instances with multiple file support activated by default.

FileUploadExt

public FileUploadExt(boolean multiple)

Constructor.

Parameters:

multiple - true to active multiple file upload support, false otherwise

FileUploadExt

protected FileUploadExt(com.google.gwt.dom.client.Element element,
                        boolean multiple)

Method Detail

isMultiple

public boolean isMultiple()

Returns true if support for multiple file upload is activated, false otherwise.

Returns:

true if support for multiple file upload is activated

setMultiple

public void setMultiple(boolean value)

Sets support for multiple file upload.

Parameters:

value - true to activate support for multiple file upload, false otherwise.

getFiles

public FileList getFiles()

Returns the files selected by the end-user.

Returns:

the files selected by the end-user.

click

public void click()

Shows the file selection box.

onBrowserEvent

public void onBrowserEvent(com.google.gwt.user.client.Event event)

Specified by:

onBrowserEvent in interface com.google.gwt.user.client.EventListener

Overrides:

onBrowserEvent in class com.google.gwt.user.client.ui.Widget

wrap

public static FileUploadExt wrap(com.google.gwt.dom.client.Element element,
                                 boolean multiple)

Creates a FileUploadExt widget that wraps an existing <input type='file'> 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

multiple - true to active multiple file upload support, false otherwise

addChangeHandler

public com.google.gwt.event.shared.HandlerRegistration addChangeHandler(com.google.gwt.event.dom.client.ChangeHandler handler)

Specified by:

addChangeHandler in interface com.google.gwt.event.dom.client.HasChangeHandlers

getFilename

public String getFilename()

Gets the filename selected by the user. This property has no mutator, as browser security restrictions preclude setting it.

Returns:

the widget's filename

getName

public String getName()

Specified by:

getName in interface com.google.gwt.user.client.ui.HasName

isEnabled

public boolean isEnabled()

Gets whether this widget is enabled.

Specified by:

isEnabled in interface com.google.gwt.user.client.ui.HasEnabled

Returns:

true if the widget is enabled

setEnabled

public void setEnabled(boolean enabled)

Sets whether this widget is enabled.

Specified by:

setEnabled in interface com.google.gwt.user.client.ui.HasEnabled

Parameters:

enabled - true to enable the widget, false to disable it

setName

public void setName(String name)

Specified by:

setName in interface com.google.gwt.user.client.ui.HasName