org.zkoss.zul
Class Fileupload

java.lang.Object
  extended by org.zkoss.zk.ui.AbstractComponent
      extended by org.zkoss.zk.ui.HtmlBasedComponent
          extended by org.zkoss.zul.impl.XulElement
              extended by org.zkoss.zul.impl.LabelElement
                  extended by org.zkoss.zul.impl.LabelImageElement
                      extended by org.zkoss.zul.Button
                          extended by org.zkoss.zul.Fileupload
All Implemented Interfaces:
java.io.Serializable, java.lang.Cloneable, HtmlBasedComponent, Component, Disable, Scope, ComponentCtrl, Button, Fileupload, LabelElement, LabelImageElement, XulElement
Direct Known Subclasses:
Fileupload

public class Fileupload
extends Button
implements Fileupload

A fileupload dialog used to let user upload a file.

There are two ways to use Fileupload:

1. Open as a modal dialog:

You don't create Fileupload directly. Rather, use get() or get(String, String).

2. Embed as part of the page:

You can create it as a component and then listen to the onUpload event (UploadEvent).

A non-XUL extension.

Author:
tomyeh
See Also:
Filedownload, Serialized Form

Nested Class Summary
 
Nested classes/interfaces inherited from class org.zkoss.zul.impl.LabelImageElement
LabelImageElement.ExtraCtrl
 
Nested classes/interfaces inherited from class org.zkoss.zk.ui.AbstractComponent
AbstractComponent.Children
 
Field Summary
 
Fields inherited from class org.zkoss.zul.Button
_upload
 
Fields inherited from class org.zkoss.zk.ui.HtmlBasedComponent
_height, _left, _top, _width, _zclass
 
Fields inherited from class org.zkoss.zk.ui.AbstractComponent
_visible
 
Fields inherited from interface org.zkoss.zk.ui.Component
APPLICATION_SCOPE, COMPONENT_SCOPE, DESKTOP_SCOPE, PAGE_SCOPE, REQUEST_SCOPE, SESSION_SCOPE, SPACE_SCOPE
 
Fields inherited from interface org.zkoss.zk.ui.sys.ComponentCtrl
CE_BUSY_IGNORE, CE_DUPLICATE_IGNORE, CE_IMPORTANT, CE_NON_DEFERRABLE, CE_REPEAT_IGNORE
 
Constructor Summary
Fileupload()
           
Fileupload(java.lang.String label)
           
Fileupload(java.lang.String label, java.lang.String image)
           
 
Method Summary
static Media get()
          Opens a modal dialog with the default message and title, and let user upload a file.
static Media get(boolean alwaysNative)
          Opens a modal dialog with the default message and title, and let user upload a file.
static Media[] get(int max)
          Opens a modal dialog to upload mulitple files with the default message and title.
static Media[] get(int max, boolean alwaysNative)
          Opens a modal dialog to upload mulitple files with the default message and title.
static Media get(java.lang.String message, java.lang.String title)
          Opens a modal dialog with the specified message and title, and let user upload a file.
static Media get(java.lang.String message, java.lang.String title, boolean alwaysNative)
          Opens a modal dialog with the specified message and title, and let user upload a file.
static Media[] get(java.lang.String message, java.lang.String title, int max)
          Opens a modal dialog to upload multiple files with the specified message and title.
static Media[] get(java.lang.String message, java.lang.String title, int max, boolean alwaysNative)
          Opens a modal dialog to upload multiple files with the specified message, title and options.
static Media[] get(java.lang.String message, java.lang.String title, int max, int maxsize, boolean alwaysNative)
          Opens a modal dialog to upload multiple files with the specified message, title and options.
 int getMaxsize()
          Deprecated. As of release 5.0.0, replaced with Button.setUpload(String)
 int getNumber()
          Deprecated. As of release 5.0.0, replaced with Button.setUpload(String)
static java.lang.String getTemplate()
          Returns the template used to create the upload modal dialog.
 boolean isNative()
          Deprecated. As of release 5.0.0, replaced with Button.setUpload(String)
 void setMaxsize(int maxsize)
          Deprecated. As of release 5.0.0, replaced with Button.setUpload(String)
 void setNative(boolean alwaysNative)
          Deprecated. As of release 5.0.0, replaced with Button.setUpload(String)
 void setNumber(int maxnum)
          Deprecated. As of release 5.0.0, replaced with Button.setUpload(String)
static void setTemplate(java.lang.String uri)
          Sets the template used to create the upload modal dialog.
 
Methods inherited from class org.zkoss.zul.Button
getAutodisable, getDir, getHref, getOrient, getTabindex, getTarget, getUpload, getZclass, isChildable, isDisabled, renderProperties, setAutodisable, setDir, setDisabled, setHref, setOrient, setTabindex, setTarget, setUpload
 
Methods inherited from class org.zkoss.zul.impl.LabelImageElement
getHoverImage, getImage, getImageContent, getSrc, isImageAssigned, newExtraCtrl, setHoverImage, setHoverImageContent, setHoverImageContent, setImage, setImageContent, setImageContent, setSrc
 
Methods inherited from class org.zkoss.zul.impl.LabelElement
getLabel, setLabel
 
Methods inherited from class org.zkoss.zul.impl.XulElement
getAction, getContext, getCtrlKeys, getPopup, getTooltip, setAction, setContext, setContext, setCtrlKeys, setPopup, setPopup, setTooltip, setTooltip
 
Methods inherited from class org.zkoss.zk.ui.HtmlBasedComponent
focus, getDraggable, getDroppable, getHeight, getHflex, getLeft, getSclass, getStyle, getTooltiptext, getTop, getVflex, getWidth, getZindex, getZIndex, service, setClass, setDraggable, setDroppable, setFocus, setHeight, setHflex, setLeft, setSclass, setStyle, setTooltiptext, setTop, setVflex, setWidth, setZclass, setZindex, setZIndex
 
Methods inherited from class org.zkoss.zk.ui.AbstractComponent
addAnnotation, addAnnotation, addClientEvent, addEventHandler, addEventListener, addForward, addForward, addForward, addForward, addMoved, addScopeListener, addSharedAnnotationMap, addSharedEventHandlerMap, appendChild, applyProperties, beforeChildAdded, beforeChildRemoved, beforeParentChanged, clone, containsVariable, detach, didActivate, didActivate, didDeserialize, didDeserialize, disableClientUpdate, equals, getAnnotatedProperties, getAnnotatedPropertiesBy, getAnnotation, getAnnotation, getAnnotations, getAnnotations, getAttribute, getAttribute, getAttribute, getAttributeOrFellow, getAttributes, getAttributes, getAuService, getChildren, getClientEvents, getDefinition, getDesktop, getEventHandler, getEventHandlerNames, getExtraCtrl, getFellow, getFellow, getFellowIfAny, getFellowIfAny, getFellows, getFirstChild, getId, getLastChild, getListenerIterator, getMold, getNamespace, getNextSibling, getPage, getParent, getPreviousSibling, getRoot, getSpaceOwner, getUuid, getVariable, getWidgetClass, getWidgetListener, getWidgetListenerNames, getWidgetOverride, getWidgetOverrideNames, hasAttribute, hasAttribute, hasAttribute, hasAttributeOrFellow, hasFellow, hasFellow, insertBefore, invalidate, isInvalidated, isListenerAvailable, isVisible, newChildren, onChildAdded, onChildRemoved, onPageAttached, onPageDetached, onWrongValue, redraw, redrawChildren, removeAttribute, removeAttribute, removeAttribute, removeChild, removeEventListener, removeForward, removeForward, removeScopeListener, render, render, render, response, sessionDidActivate, sessionWillPassivate, setAttribute, setAttribute, setAttribute, setAuService, setDefinition, setDefinition, setId, setMold, setPage, setPageBefore, setParent, setVariable, setVisible, setWidgetListener, setWidgetOverride, smartUpdate, smartUpdate, smartUpdate, smartUpdate, smartUpdate, smartUpdate, smartUpdate, smartUpdate, smartUpdate, smartUpdateWidgetListener, smartUpdateWidgetOverride, toString, unsetVariable, updateByClient, willPassivate, willPassivate, willSerialize, willSerialize
 
Methods inherited from class java.lang.Object
finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 
Methods inherited from interface org.zkoss.zk.ui.api.HtmlBasedComponent
focus, getHeight, getLeft, getSclass, getStyle, getTooltiptext, getTop, getWidth, getZclass, getZindex, getZIndex, setDraggable, setDroppable, setFocus, setHeight, setLeft, setSclass, setStyle, setTooltiptext, setTop, setWidth, setZclass, setZindex, setZIndex
 
Methods inherited from interface org.zkoss.zk.ui.Component
addEventListener, addForward, addForward, addForward, addForward, appendChild, applyProperties, clone, containsVariable, detach, getAttribute, getAttribute, getAttributeOrFellow, getAttributes, getAttributes, getAuService, getChildren, getDefinition, getDesktop, getFellow, getFellow, getFellowIfAny, getFellowIfAny, getFellows, getFirstChild, getId, getLastChild, getListenerIterator, getMold, getNamespace, getNextSibling, getPage, getParent, getPreviousSibling, getRoot, getSpaceOwner, getUuid, getVariable, getWidgetClass, getWidgetListener, getWidgetListenerNames, getWidgetOverride, getWidgetOverrideNames, hasAttribute, hasAttribute, hasAttributeOrFellow, hasFellow, hasFellow, insertBefore, invalidate, isInvalidated, isListenerAvailable, isVisible, removeAttribute, removeAttribute, removeChild, removeEventListener, removeForward, removeForward, setAttribute, setAttribute, setAuService, setId, setMold, setPage, setPageBefore, setParent, setVariable, setVisible, setWidgetListener, setWidgetOverride, unsetVariable
 
Methods inherited from interface org.zkoss.zk.ui.ext.Scope
addScopeListener, getAttribute, hasAttribute, removeAttribute, removeScopeListener, setAttribute
 
Methods inherited from interface org.zkoss.zul.impl.api.LabelImageElement
getHoverImage, getImage, getImageContent, setHoverImage, setHoverImageContent, setHoverImageContent, setImage, setImageContent, setImageContent
 
Methods inherited from interface org.zkoss.zul.impl.api.LabelElement
getLabel, setLabel
 
Methods inherited from interface org.zkoss.zul.impl.api.XulElement
getAction, getContext, getCtrlKeys, getPopup, getTooltip, setAction, setContext, setContext, setCtrlKeys, setPopup, setPopup, setTooltip, setTooltip
 

Constructor Detail

Fileupload

public Fileupload()

Fileupload

public Fileupload(java.lang.String label)

Fileupload

public Fileupload(java.lang.String label,
                  java.lang.String image)
Method Detail

getMaxsize

public int getMaxsize()
Deprecated. As of release 5.0.0, replaced with Button.setUpload(String)


setMaxsize

public void setMaxsize(int maxsize)
Deprecated. As of release 5.0.0, replaced with Button.setUpload(String)


getNumber

public int getNumber()
Deprecated. As of release 5.0.0, replaced with Button.setUpload(String)

Description copied from interface: Fileupload
Returns the maximal allowed number of files to upload.

Specified by:
getNumber in interface Fileupload

setNumber

public void setNumber(int maxnum)
               throws WrongValueException
Deprecated. As of release 5.0.0, replaced with Button.setUpload(String)

Description copied from interface: Fileupload
Sets the maximal allowed number of files to upload.

Default: 1.

Specified by:
setNumber in interface Fileupload
Parameters:
maxnum - the maximal allowed number (positive or negative). The value can be negative, which means no limitation at all and the end user can upload any numbers he wants
Throws:
WrongValueException - if non-positive, or it exceeds 1000

isNative

public boolean isNative()
Deprecated. As of release 5.0.0, replaced with Button.setUpload(String)

Description copied from interface: Fileupload
Returns whether to treat the uploaded file(s) as binary, i.e., not to convert it to image, audio or text files.

Default: false.

Specified by:
isNative in interface Fileupload
See Also:
Configuration.getUploadCharset(), Configuration.getUploadCharsetFinder()

setNative

public void setNative(boolean alwaysNative)
Deprecated. As of release 5.0.0, replaced with Button.setUpload(String)

Description copied from interface: Fileupload
Sets whether to treat the uploaded file(s) as binary, i.e., not to convert it to image, audio or text files.

Specified by:
setNative in interface Fileupload
Parameters:
alwaysNative - whether to treat the uploaded file as binary stream, regardless its content type. If false (the default), it will convert to Image, Audio, binary stream, or text files depending on the content type.
See Also:
Configuration.setUploadCharset(java.lang.String), Configuration.setUploadCharsetFinder(org.zkoss.zk.ui.util.CharsetFinder)

get

public static Media get()
                 throws java.lang.InterruptedException
Opens a modal dialog with the default message and title, and let user upload a file.

Returns:
the uploaded content, or null if not uploaded.
Throws:
java.lang.InterruptedException

get

public static Media get(boolean alwaysNative)
                 throws java.lang.InterruptedException
Opens a modal dialog with the default message and title, and let user upload a file.

Parameters:
alwaysNative - whether to treat the uploaded file as binary stream, regardless its content type. If false (the default), it will convert to Image, Audio, binary stream, or text files depending on the content type.
Returns:
the uploaded content, or null if not uploaded.
Throws:
java.lang.InterruptedException
Since:
3.0.0
See Also:
Configuration.getUploadCharset(), Configuration.getUploadCharsetFinder()

get

public static Media get(java.lang.String message,
                        java.lang.String title)
                 throws java.lang.InterruptedException
Opens a modal dialog with the specified message and title, and let user upload a file.

Parameters:
message - the message. If null, the default is used.
title - the title. If null, the default is used.
Returns:
the uploaded content, or null if not ready.
Throws:
java.lang.InterruptedException

get

public static Media get(java.lang.String message,
                        java.lang.String title,
                        boolean alwaysNative)
                 throws java.lang.InterruptedException
Opens a modal dialog with the specified message and title, and let user upload a file.

Parameters:
message - the message. If null, the default is used.
title - the title. If null, the default is used.
alwaysNative - whether to treat the uploaded file as binary stream, regardless its content type. If false (the default), it will convert to Image, Audio, binary stream, or text files depending on the content type.
Returns:
the uploaded content, or null if not ready.
Throws:
java.lang.InterruptedException
Since:
3.0.0
See Also:
Configuration.getUploadCharset(), Configuration.getUploadCharsetFinder()

get

public static Media[] get(int max)
                   throws java.lang.InterruptedException
Opens a modal dialog to upload mulitple files with the default message and title.

Parameters:
max - the maximal allowed number that an user can upload at once. If nonpositive, 1 is assumed.
Returns:
an array of files that an users has uploaded, or null if uploaded.
Throws:
java.lang.InterruptedException

get

public static Media[] get(int max,
                          boolean alwaysNative)
                   throws java.lang.InterruptedException
Opens a modal dialog to upload mulitple files with the default message and title.

Parameters:
max - the maximal allowed number that an user can upload at once. If nonpositive, 1 is assumed.
alwaysNative - whether to treat the uploaded files as binary stream, regardless its content type. If false (the default), it will convert to Image, Audio, binary stream, or text files depending on the content type.
Returns:
an array of files that an users has uploaded, or null if uploaded.
Throws:
java.lang.InterruptedException
Since:
3.0.0
See Also:
Configuration.getUploadCharset(), Configuration.getUploadCharsetFinder()

get

public static Media[] get(java.lang.String message,
                          java.lang.String title,
                          int max)
                   throws java.lang.InterruptedException
Opens a modal dialog to upload multiple files with the specified message and title.

The returned format depending on the content type.

Parameters:
max - the maximal allowed number that an user can upload at once. If nonpositive, 1 is assumed. If max is larger than 1000, 1000 is assumed.
Returns:
an array of files that an users has uploaded, or null if uploaded.
Throws:
java.lang.InterruptedException

get

public static Media[] get(java.lang.String message,
                          java.lang.String title,
                          int max,
                          boolean alwaysNative)
                   throws java.lang.InterruptedException
Opens a modal dialog to upload multiple files with the specified message, title and options.

Parameters:
max - the maximal allowed number that an user can upload at once. If nonpositive, 1 is assumed. If max is larger than 1000, 1000 is assumed.
alwaysNative - whether to treat the uploaded files as binary stream, regardless its content type. If false (the default), it will convert to Image, Audio, binary stream, or text files depending on the content type.
Returns:
an array of files that an users has uploaded, or null if uploaded.
Throws:
java.lang.InterruptedException
Since:
3.0.0

get

public static Media[] get(java.lang.String message,
                          java.lang.String title,
                          int max,
                          int maxsize,
                          boolean alwaysNative)
                   throws java.lang.InterruptedException
Opens a modal dialog to upload multiple files with the specified message, title and options.

Parameters:
max - the maximal allowed number that an user can upload at once. If nonpositive, 1 is assumed. If max is larger than 1000, 1000 is assumed.
maxsize - the maximal upload size of the component.
alwaysNative - whether to treat the uploaded files as binary stream, regardless its content type. If false (the default), it will convert to Image, Audio, binary stream, or text files depending on the content type.
Returns:
an array of files that an users has uploaded, or null if uploaded.
Throws:
java.lang.InterruptedException
Since:
3.6.0

setTemplate

public static void setTemplate(java.lang.String uri)
Sets the template used to create the upload modal dialog.

The template must follow the default template: ~./zul/html/fileuploaddlg.zul

In other words, just adjust the label and layout and don't change the component's ID.

Note: the template has no effect, if you use Fileupload as a component (and embed it to a page).


getTemplate

public static java.lang.String getTemplate()
Returns the template used to create the upload modal dialog.



Copyright © 2005-2009 Potix Corporation. All Rights Reserved. SourceForge.net Logo