public class FileItem extends CanvasItem
Editable mode
 The editForm will be automatically generated and displayed as 
 this.canvas, allowing the user to select file(s) to
 upload. 
 See the Upload Overview for information on using this control. 
Read-only mode
 For fields of type "blob" the raw data value will be displayed in the  generated
 displayForm. 
 For other fields, the displayCanvas will be displayed. 
 For
 "imageFile" fields with showFileInline set to true, the image-file will be streamed and displayed inline within the displayCanvas. 
 Otherwise, the displayCanvas will render out View and  Download icons and the fileName.
Upload overview and related methodsFormItem.CustomStateGetter, FormItem.StateCustomizerconfigOnly, scClassName, warnOnEditorTypeConversion, warnOnEditorTypeConversionDefaultidfactoryCreated, factoryProperties| Constructor and Description | 
|---|
| FileItem() | 
| FileItem(com.google.gwt.core.client.JavaScriptObject jsObj) | 
| FileItem(java.lang.String name) | 
| FileItem(java.lang.String name,
        java.lang.String title) | 
| Modifier and Type | Method and Description | 
|---|---|
| static void | changeAutoChildDefaults(java.lang.String autoChildName,
                       Canvas defaults)Changes the defaults for Canvas AutoChildren named  autoChildName. | 
| static void | changeAutoChildDefaults(java.lang.String autoChildName,
                       FormItem defaults)Changes the defaults for FormItem AutoChildren named  autoChildName. | 
| static void | changePickerIconDefaults(FormItemIcon defaults) | 
| java.lang.String | getAccept()A comma-separated list of valid MIME types, used as a filter for the file picker window. | 
| java.lang.String | getCapture()This attribute enables camera capture functionality for mobile devices, accepting the  following values:  Set it
 to "user" to capture using the front-facing camera. Set it to "environment" to capture using the rear-facing
 camera.  | 
| Canvas | getDisplayCanvas() | 
| DynamicForm | getDisplayForm()The  DynamicFormcreated automatically whencanEditis false and the field is of type "blob". | 
| StaticTextItem | getDisplayItem()The  StaticTextItemcreated automatically and displayed in thedisplayFormwhencanEditis false and the field type is "blob". | 
| java.lang.String | getDownloadIconSrc()Returns the URL for an Icon that will allow the file to be downloaded | 
| DynamicForm | getEditForm()The  DynamicFormcreated automatically whencanEditis true. | 
| java.lang.String | getEditProxyConstructor()Default class used to construct the  EditProxyfor this component when the component isfirst placed into edit mode. | 
| java.lang.Boolean | getMultiple()When true, allow the file-selection dialog shelled by the browser to select multiple 
  files. | 
| static FileItem | getOrCreateRef(com.google.gwt.core.client.JavaScriptObject jsObj) | 
| java.lang.Boolean | getShouldSaveValue()Should this item's value be saved in the form's values and hence returned from  form.getValues()? | 
| java.lang.Boolean | getShowFileInline()Indicates whether to stream the image and display it inline or to display the View and Download icons. | 
| UploadItem | getUploadItem() | 
| java.lang.String | getViewIconSrc()Returns the URL for an Icon that will allow the file to be viewed. | 
| FileItem | setAccept(java.lang.String accept)A comma-separated list of valid MIME types, used as a filter for the file picker window. | 
| FileItem | setCapture(java.lang.String capture)This attribute enables camera capture functionality for mobile devices, accepting the  following values:  Set it
 to "user" to capture using the front-facing camera. Set it to "environment" to capture using the rear-facing
 camera.  | 
| static void | setDefaultProperties(FileItem fileItemProperties)Class level method to set the default properties of this class. | 
| FileItem | setDownloadIconSrc(java.lang.String downloadIconSrc)Returns the URL for an Icon that will allow the file to be downloaded | 
| FileItem | setEditProxyConstructor(java.lang.String editProxyConstructor)Default class used to construct the  EditProxyfor this component when the component isfirst placed into edit mode. | 
| FileItem | setMultiple(java.lang.Boolean multiple)When true, allow the file-selection dialog shelled by the browser to select multiple 
  files. | 
| FileItem | setShouldSaveValue(java.lang.Boolean shouldSaveValue)Should this item's value be saved in the form's values and hence returned from  form.getValues()? | 
| FileItem | setShowFileInline(java.lang.Boolean showFileInline)Indicates whether to stream the image and display it inline or to display the View and Download icons. | 
| FileItem | setViewIconSrc(java.lang.String viewIconSrc)Returns the URL for an Icon that will allow the file to be viewed. | 
addCanEditChangedHandler, addReadOnlyDisplayChangedHandler, addShowValueHandler, createCanvas, getApplyPromptToCanvas, getAutoDestroy, getCanvas, getEditCriteriaInInnerForm, getHeight, getHeightAsString, getMaxHeight, getMinHeight, getOverflow, getPrompt, hasAdvancedCriteria, isFocused, setApplyPromptToCanvas, setAutoDestroy, setCanEditCriterionPredicate, setCanvas, setCriterionGetter, setCriterionSetter, setDefaultProperties, setEditCriteriaInInnerForm, setHeight, setHeight, setMaxHeight, setMinHeight, setOverflow, setPrompt, setShouldDisableCanvasCustomizer, setupCanvasConstructor, storeValue, storeValue, storeValue, updateCanvasTabPosition_getValue, addBlurHandler, addChangedHandler, addChangeHandler, addClickHandler, addDoubleClickHandler, addEditorEnterHandler, addEditorExitHandler, addFocusHandler, addIcon, addIcon, addIconClickHandler, addIconKeyPressHandler, addItemHoverHandler, addKeyDownHandler, addKeyPressHandler, addKeyUpHandler, addPendingStatusChangedHandler, addPickerIconClickHandler, addShowContextMenuHandler, addTitleClickHandler, addTitleDoubleClickHandler, addTitleHoverHandler, addValueHoverHandler, addValueIconClickHandler, applyFormula, asSGWTComponent, blurItem, canEditCriterion, clearErrors, clearValue, disable, disableIcon, enable, enableIcon, error, error, errorIfNotCreated, focusAfterItem, focusInItem, getAccessKey, getAlign, getAllowExpressions, getAlwaysFetchMissingValues, getAlwaysShowControlBox, getApplyAlignToText, getApplyHeightToTextBox, getAriaRole, getAttribute, getAttributeAsBoolean, getAttributeAsBoolean, getAttributeAsDate, getAttributeAsDouble, getAttributeAsFloat, getAttributeAsInt, getAttributeAsJavaScriptObject, getAttributeAsObject, getAttributeAsString, getAutoComplete, getAutoCompleteKeywords, getBrowserInputType, getBrowserSpellCheck, getCanEdit, getCanEditOpaqueValues, getCanFocus, getCanSelectText, getCanTabToIcons, getCanvasAutoChild, getCellHeight, getCellStyle, getChangeOnKeypress, getClassName, getClipStaticValue, getClipTitle, getConfig, getContainerWidget, getControlStyle, getCriteriaField, getCriterion, getCriterion, getCursorPosition, getCustomState, getDataPath, getDateFormatter, getDecimalPad, getDecimalPrecision, getDefaultIconSrc, getDefaultOperator, getDestroyed, getDisabled, getDisabledHover, getDisableIconsOnReadOnly, getDisplayField, getDisplayFieldName, getDisplayValue, getDisplayValue, getEditorTypeConfig, getEditPendingCSSText, getEmptyDisplayValue, getEmptyValueIcon, getEndRow, getErrorIconHeight, getErrorIconSrc, getErrorIconWidth, getErrorMessageWidth, getErrors, getEscapeHTML, getExportFormat, getFetchMissingValues, getFieldName, getFilterLocally, getForeignDisplayField, getForm, getFormat, getFormItemAutoChild, getFormula, getFullDataPath, getGlobalTabIndex, getGridColNum, getGridRowNum, getHidden, getHint, getHintStyle, getHoverAlign, getHoverDelay, getHoverFocusKey, getHoverHeight, getHoverHeightAsString, getHoverOpacity, getHoverPersist, getHoverStyle, getHoverVAlign, getHoverWidth, getHoverWidthAsString, getIcon, getIconHeight, getIconHSpace, getIconPageRect, getIconPrompt, getIconRect, getIcons, getIconTabPosition, getIconVAlign, getIconWidth, getID, getImageURLPrefix, getImageURLSuffix, getImplicitSave, getImplicitSaveOnBlur, getInputFormat, getLeft, getLinearColSpan, getLinearColSpanAsString, getLinearEndRow, getLinearEndRowAsString, getLinearStartRow, getLinearStartRowAsString, getLinearWidth, getLinearWidthAsString, getListGrid, getLoadingDisplayValue, getLocateItemBy, getMinHintWidth, getMultipleValueSeparator, getName, getNullOriginalValueText, getOperator, getOptionCriteria, getOptionDataSource, getOptionDataSourceAsString, getOptionFilterContext, getOptionOperationId, getOptionTextMatchStyle, getOriginalValueMessage, getPageLeft, getPageRect, getPageTop, getPaletteDefaults, getPicker, getPickerIcon, getPickerIcon, getPickerIconHeight, getPickerIconName, getPickerIconPrompt, getPickerIconProperties, getPickerIconSrc, getPickerIconStyle, getPickerIconTabPosition, getPickerIconWidth, getPixelHeight, getPixelWidth, getPrintReadOnlyTextBoxStyle, getPrintTextBoxStyle, getPrintTitleStyle, getReadOnlyCanSelectText, getReadOnlyControlStyle, getReadOnlyDisplay, getReadOnlyHover, getReadOnlyTextBoxStyle, getReadOnlyWhen, getRect, getRedrawOnChange, getRejectInvalidValueOnChange, getRequired, getRequiredMessage, getRequiredWhen, getRowSpan, getSaveOnEnter, getScClassName, getSelectedRecord, getSelectOnClick, getSelectOnFocus, getShowClippedTitleOnHover, getShowClippedValueOnHover, getShowDeletions, getShowDisabled, getShowDisabledIconsOnFocus, getShowDisabledPickerIconOnFocus, getShowErrorIcon, getShowErrorStyle, getShowErrorText, getShowFocused, getShowFocusedErrorState, getShowFocusedIcons, getShowFocusedPickerIcon, getShowHint, getShowIcons, getShowIconsOnFocus, getShowImageAsURL, getShowOldValueInHover, getShowOver, getShowOverIcons, getShowPending, getShowPickerIcon, getShowPickerIconOnFocus, getShowRTL, getShowTitle, getShowValueIconOnly, getStartRow, getStaticHeight, getStopOnError, getStoreDisplayValues, getSupportsCutPasteEvents, getSuppressValueIcon, getSynchronousValidation, getTabIndex, getTextAlign, getTextBoxStyle, getTextFormula, getTimeFormatter, getTitle, getTitleAlign, getTitleColSpan, getTitleOrientation, getTitleStyle, getTitleVAlign, getTooltip, getTop, getType, getUpdateControlOnOver, getUpdatePickerIconOnOver, getUpdateTextBoxOnOver, getUseAdvancedCriteria, getUseDisabledHintStyleForReadOnly, getUseLocalDisplayFieldValue, getValidateOnChange, getValidateOnExit, getValidOperators, getVAlign, getValue, getValueAsFloat, getValueAsInteger, getValueAsLong, getValueAsRecordList, getValueDeselectedCSSText, getValueField, getValueFieldName, getValueIconHeight, getValueIconLeftPadding, getValueIconRightPadding, getValueIconSize, getValueIconWidth, getValueMap, getValueMapAsArray, getVisible, getVisibleHeight, getVisibleTitleWidth, getVisibleWhen, getVisibleWidth, getWarnOnEditorTypeConversion, getWarnOnEditorTypeConversionDefault, getWidth, getWidthAsString, getWrapHintText, getWrapStaticValue, getWrapTitle, handleWarnOnEditorTypeConversion, hasErrors, hide, hideIcon, invalidateDisplayValueCache, isConfigOnly, isCreated, isCutEvent, isDisabled, isDrawn, isInGrid, isPasteEvent, isVisible, linkToInstanceUponCreate, mapDisplayToValue, mapValueToDisplay, mapValueToDisplay, mapValueToDisplay, redraw, redraw, removeIcon, selectedRecordChanged, setAccessKey, setAlign, setAllowExpressions, setAlwaysFetchMissingValues, setAlwaysShowControlBox, setApplyAlignToText, setApplyHeightToTextBox, setAriaRole, setAriaState, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAutoChildConstructor, setAutoChildProperties, setAutoChildProperties, setAutoChildProperties, setAutoChildVisibility, setAutoComplete, setAutoCompleteKeywords, setBrowserInputType, setBrowserSpellCheck, setCanEdit, setCanEditOpaqueValues, setCanFocus, setCanSelectText, setCanTabToIcons, setCellHeight, setCellStyle, setChangeOnKeypress, setClipStaticValue, setClipTitle, setColSpan, setColSpan, setConfigOnly, setControlStyle, setCriteriaField, setCriterion, setCustomStateGetter, setDataPath, setDateFormatter, setDecimalPad, setDecimalPrecision, setDefaultIconSrc, setDefaultOperator, setDefaultProperties, setDefaultValue, setDefaultValue, setDefaultValue, setDefaultValue, setDefaultValue, setDefaultValue, setDefaultValue, setDisabled, setDisabledHover, setDisableIconsOnReadOnly, setDisplayField, setDisplayFormat, setDisplayFormat, setEditorProperties, setEditorType, setEditorType, setEditorType, setEditorValueFormatter, setEditorValueParser, setEditPendingCSSText, setEmptyDisplayValue, setEmptyValueIcon, setEndRow, setErrorFormatter, setErrorIconHeight, setErrorIconSrc, setErrorIconWidth, setErrorMessageWidth, setErrorOrientation, setErrors, setErrors, setEscapeHTML, setExportFormat, setFetchMissingValues, setFilterLocally, setForeignDisplayField, setFormat, setFormula, setGlobalTabIndex, setHidden, setHint, setHintStyle, setHoverAlign, setHoverDelay, setHoverFocusKey, setHoverHeight, setHoverHeight, setHoverOpacity, setHoverPersist, setHoverStyle, setHoverVAlign, setHoverWidth, setHoverWidth, setIconDisabled, setIconHeight, setIconHSpace, setIconPrompt, setIcons, setIconShowOnFocus, setIconVAlign, setIconWidth, setID, setImageURLPrefix, setImageURLSuffix, setImplicitSave, setImplicitSaveOnBlur, setInitHandler, setInputFormat, setInputTransformer, setItemHoverFormatter, setItemTitleHoverFormatter, setItemValueHoverFormatter, setJavaScriptObject, setLeft, setLinearColSpan, setLinearColSpan, setLinearEndRow, setLinearEndRow, setLinearStartRow, setLinearStartRow, setLinearWidth, setLinearWidth, setLoadingDisplayValue, setLocateItemBy, setMinHintWidth, setMultipleValueSeparator, setName, setNullOriginalValueText, setNullProperty, setOperator, setOptionCriteria, setOptionDataSource, setOptionDataSource, setOptionFilterContext, setOptionOperationId, setOptionTextMatchStyle, setOriginalValueMessage, setPickerIconHeight, setPickerIconName, setPickerIconPrompt, setPickerIconProperties, setPickerIconSrc, setPickerIconStyle, setPickerIconWidth, setPrintReadOnlyTextBoxStyle, setPrintTextBoxStyle, setPrintTitleStyle, setProperty, setProperty, setProperty, setProperty, setProperty, setReadOnlyCanSelectText, setReadOnlyControlStyle, setReadOnlyDisplay, setReadOnlyHover, setReadOnlyTextBoxStyle, setReadOnlyWhen, setRedrawOnChange, setRejectInvalidValueOnChange, setRequired, setRequiredMessage, setRequiredWhen, setRowSpan, setSaveOnEnter, setScClassName, setSelectOnClick, setSelectOnFocus, setShowClippedTitleOnHover, setShowClippedValueOnHover, setShowDeletions, setShowDisabled, setShowDisabledIconsOnFocus, setShowDisabledPickerIconOnFocus, setShowErrorIcon, setShowErrorStyle, setShowErrorText, setShowFocused, setShowFocusedErrorState, setShowFocusedIcons, setShowFocusedPickerIcon, setShowHint, setShowIcons, setShowIconsOnFocus, setShowIfCondition, setShowImageAsURL, setShowOldValueInHover, setShowOver, setShowOverIcons, setShowPending, setShowPickerIcon, setShowPickerIconOnFocus, setShowRTL, setShowTitle, setShowValueIconOnly, setStartRow, setStateCustomizer, setStaticHeight, setStopOnError, setStoreDisplayValues, setSupportsCutPasteEvents, setSuppressValueIcon, setSynchronousValidation, setTabIndex, setTextAlign, setTextBoxStyle, setTextFormula, setTimeFormatter, setTitle, setTitleAlign, setTitleColSpan, setTitleHoverFormatter, setTitleOrientation, setTitleStyle, setTitleVAlign, setTooltip, setTop, setType, setUpdateControlOnOver, setUpdatePickerIconOnOver, setUpdateTextBoxOnOver, setUseAdvancedCriteria, setUseDisabledHintStyleForReadOnly, setUseLocalDisplayFieldValue, setValidateOnChange, setValidateOnExit, setValidators, setValidOperators, setVAlign, setValue, setValue, setValue, setValue, setValue, setValue, setValueDeselectedCSSText, setValueField, setValueFormatter, setValueHoverFormatter, setValueIconHeight, setValueIconLeftPadding, setValueIconMapper, setValueIconRightPadding, setValueIcons, setValueIconSize, setValueIconWidth, setValueMap, setValueMap, setVisible, setVisibleWhen, setWarnOnEditorTypeConversion, setWarnOnEditorTypeConversionDefault, setWidth, setWidth, setWrapHintText, setWrapStaticValue, setWrapTitle, shouldApplyHeightToTextBox, shouldFetchMissingValue, shouldSaveOnEnter, shouldStopKeyPressBubbling, show, showIcon, showPicker, stopHover, storeValue, updateState, validate, valueClippedgetRef, getRef, internalSetIDapplyFactoryProperties, doAddHandler, fireEvent, getAttributeAsDoubleArray, getAttributeAsElement, getAttributeAsIntArray, getAttributeAsLong, getAttributeAsMap, getAttributeAsObject, getAttributeAsRecord, getAttributeAsStringArray, getAttributes, getHandlerCount, isFactoryCreated, setAttribute, setAttribute, setAttribute, setAttributeAsJavaObject, setFactoryCreatedpublic FileItem()
public FileItem(com.google.gwt.core.client.JavaScriptObject jsObj)
public FileItem(java.lang.String name)
public FileItem(java.lang.String name,
                java.lang.String title)
public static FileItem getOrCreateRef(com.google.gwt.core.client.JavaScriptObject jsObj)
public static void changeAutoChildDefaults(java.lang.String autoChildName,
                                           Canvas defaults)
autoChildName.autoChildName - name of an AutoChild to customize the defaults for.defaults - Canvas defaults to apply. These defaults override any existing properties
 without destroying or wiping out non-overridden properties.  For usage tips on this
 param, see SGWTProperties.AutoChildUsagepublic static void changeAutoChildDefaults(java.lang.String autoChildName,
                                           FormItem defaults)
autoChildName.autoChildName - name of an AutoChild to customize the defaults for.defaults - FormItem defaults to apply. These defaults override any existing properties
 without destroying or wiping out non-overridden properties.  For usage tips on this
 param, see SGWTProperties.AutoChildUsagepublic static void changePickerIconDefaults(FormItemIcon defaults)
public FileItem setAccept(java.lang.String accept)
 Note that this property
 makes use of the HTML accept attribute, and so relies on the browser to perform the desired filtering.  For
 further study, see:
accept - New accept value. Default value is nullFileItem instance, for chaining setter callspublic java.lang.String getAccept()
 Note that this property
 makes use of the HTML accept attribute, and so relies on the browser to perform the desired filtering.  For
 further study, see:
public FileItem setCapture(java.lang.String capture)
Please note that in the latest versions of Android and iOS, utilizing this attribute will consistently load the rear camera. This behavior is due to the direct camera software's ability to switch between the two cameras seamlessly.
When working with the capture functionality of iPhones and Android devices, it's important to consider the supported DataSourceField.mimeTypes for audio, video, and image files that can be used with the fileItem.accept attribute. Here's a list of commonly supported mime types for capturing on these devices:
Supported Image Mime Types:
The behavior of using the capture attribute depends on the value used in the accept attribute. For example:
Lastly, keep in mind that these settings have no effect on desktop browsers; they apply exclusively to mobile devices.
This information is "circa 2023" and may not apply to all devices.
capture - New capture value. Default value is nullFileItem instance, for chaining setter callspublic java.lang.String getCapture()
Please note that in the latest versions of Android and iOS, utilizing this attribute will consistently load the rear camera. This behavior is due to the direct camera software's ability to switch between the two cameras seamlessly.
When working with the capture functionality of iPhones and Android devices, it's important to consider the supported DataSourceField.mimeTypes for audio, video, and image files that can be used with the fileItem.accept attribute. Here's a list of commonly supported mime types for capturing on these devices:
Supported Image Mime Types:
The behavior of using the capture attribute depends on the value used in the accept attribute. For example:
Lastly, keep in mind that these settings have no effect on desktop browsers; they apply exclusively to mobile devices.
This information is "circa 2023" and may not apply to all devices.
public Canvas getDisplayCanvas()
Canvas created automatically when canEdit is false and the field is of any type other than
 "blob".  If the field is of type "imageFile", and showFileInline  is true, the contents of the canvas
 are set to HTML that streams the image file for  display. Otherwise, the item renders icons that allow the file to be 
 viewed or downloaded. 
 This component is an com.smartgwt.client.types.AutoChild and as such may be customized via  fileItem.displayCanvasDefaults and 
 fileItem.displayCanvasProperties.
 
 This component is an AutoChild named "displayCanvas".  For an overview of how to use and
 configure AutoChildren, see Using AutoChildren.
Upload overview and related methodspublic DynamicForm getDisplayForm()
DynamicForm created automatically when canEdit is false and the field is of type "blob". Displays
 a single  item for viewing the content of a blob
 file.  This component is an com.smartgwt.client.types.AutoChild and as such may be customized via 
 fileItem.displayFormDefaults and fileItem.displayFormProperties.
 
 This component is an AutoChild named "displayForm".  For an overview of how to use and
 configure AutoChildren, see Using AutoChildren.
Upload overview and related methodspublic StaticTextItem getDisplayItem()
StaticTextItem created automatically and displayed in the  displayForm when canEdit is false and the field type is "blob".  This
 component is an com.smartgwt.client.types.AutoChild and as such may be customized via 
 fileItem.displayItemDefaults and fileItem.displayItemProperties.  
 This component is an AutoChild named "displayItem".  For an overview of how to use and
 configure AutoChildren, see Using AutoChildren.
Upload overview and related methodspublic FileItem setDownloadIconSrc(java.lang.String downloadIconSrc)
downloadIconSrc - New downloadIconSrc value. Default value is "[SKIN]actions/download.png"FileItem instance, for chaining setter callsSCImgURL, 
Images overview and related methodspublic java.lang.String getDownloadIconSrc()
SCImgURL, 
Images overview and related methodspublic DynamicForm getEditForm()
DynamicForm created automatically when canEdit is true. Displays a single item for manipulating a file.  This component is an
 com.smartgwt.client.types.AutoChild and as such may be customized via  fileItem.editFormDefaults
 and fileItem.editFormProperties. 
 This component is an AutoChild named "editForm".  For an overview of how to use and
 configure AutoChildren, see Using AutoChildren.
Upload overview and related methodspublic FileItem setEditProxyConstructor(java.lang.String editProxyConstructor)
EditProxy for this component when the component is
 first placed into edit mode.setEditProxyConstructor in class FormItemeditProxyConstructor - New editProxyConstructor value. Default value is "FileItemEditProxy"FileItem instance, for chaining setter callsSCClassNamepublic java.lang.String getEditProxyConstructor()
EditProxy for this component when the component is
 first placed into edit mode.getEditProxyConstructor in class FormItemSCClassNamepublic FileItem setMultiple(java.lang.Boolean multiple)
Support is not full-cycle at the server - that is, there are server APIs for retrieving each file that was uploaded, but no built-in support for storing multiple files against a single DataSource field. However, you can write custom server DMI code to do something with the files - for instance, you could create multiple new DataSource records for each file via a server DMI like this below:
     String fileNameStr = (String)dsRequest.getValues().get("image_filename").toString();
 
     String[] fileNames = fileNameStr.split(", ");
     List files = dsRequest.getUploadedFiles();
 
     for (int i = 0; i < files.size(); i++) {
         ISCFileItem file = (ISCFileItem)files.get(i);
         InputStream fileData = file.getInputStream();
         DSRequest inner = new DSRequest("mediaLibrary", "add");
         Map values = new HashMap();
         values.put("title", dsRequest.getValues().get("title"));
         values.put("image", fileData);
         values.put("image_filename", fileNames[i]);
         values.put("image_filesize", file.getSize());
         values.put("image_date_created", new Date());
         
         inner.setValues(values);
         inner.execute();
     }
     
     DSResponse dsResponse = new DSResponse();
     
     dsResponse.setStatus(0);
 
     return dsResponse;
  
 multiple setting at runtime, propagating it to the Browser's file dialog.  Causes a redraw.setMultiple in class CanvasItemmultiple - the HTML of the view link. Default value is trueFileItem instance, for chaining setter callsAppearance overview and related methodspublic java.lang.Boolean getMultiple()
Support is not full-cycle at the server - that is, there are server APIs for retrieving each file that was uploaded, but no built-in support for storing multiple files against a single DataSource field. However, you can write custom server DMI code to do something with the files - for instance, you could create multiple new DataSource records for each file via a server DMI like this below:
     String fileNameStr = (String)dsRequest.getValues().get("image_filename").toString();
 
     String[] fileNames = fileNameStr.split(", ");
     List files = dsRequest.getUploadedFiles();
 
     for (int i = 0; i < files.size(); i++) {
         ISCFileItem file = (ISCFileItem)files.get(i);
         InputStream fileData = file.getInputStream();
         DSRequest inner = new DSRequest("mediaLibrary", "add");
         Map values = new HashMap();
         values.put("title", dsRequest.getValues().get("title"));
         values.put("image", fileData);
         values.put("image_filename", fileNames[i]);
         values.put("image_filesize", file.getSize());
         values.put("image_date_created", new Date());
         
         inner.setValues(values);
         inner.execute();
     }
     
     DSResponse dsResponse = new DSResponse();
     
     dsResponse.setStatus(0);
 
     return dsResponse;
  getMultiple in class CanvasItemAppearance overview and related methodspublic FileItem setShouldSaveValue(java.lang.Boolean shouldSaveValue)
form.getValues()?  shouldSaveValue:false is used
 to mark formItems which do not correspond to the underlying data model and should not save a value into the form's
 values.  Example includes visual separators, password
 re-type fields, or checkboxes used to show/hide other form items. 
 A shouldSaveValue:false item should
 be given a value either via FormItem.defaultValue or by calling form.setValue(item,
 value) or  formItem.setValue(value).  Providing a
 value via form.values or form.setValues()  will automatically switch the item to
 shouldSaveValue:true. 
Note that
setShouldSaveValue in class CanvasItemshouldSaveValue - New shouldSaveValue value. Default value is trueFileItem instance, for chaining setter callspublic java.lang.Boolean getShouldSaveValue()
form.getValues()?  shouldSaveValue:false is used
 to mark formItems which do not correspond to the underlying data model and should not save a value into the form's
 values.  Example includes visual separators, password
 re-type fields, or checkboxes used to show/hide other form items. 
 A shouldSaveValue:false item should
 be given a value either via FormItem.defaultValue or by calling form.setValue(item,
 value) or  formItem.setValue(value).  Providing a
 value via form.values or form.setValues()  will automatically switch the item to
 shouldSaveValue:true. 
Note that
getShouldSaveValue in class CanvasItempublic FileItem setShowFileInline(java.lang.Boolean showFileInline)
showFileInline - New showFileInline value. Default value is nullFileItem instance, for chaining setter callspublic java.lang.Boolean getShowFileInline()
public UploadItem getUploadItem()
UploadItem created automatically and displayed in the  editForm when canEdit is true.  This component is an com.smartgwt.client.types.AutoChild and as such may be customized via  fileItem.uploadItemDefaults and
 fileItem.uploadItemProperties. 
 This component is an AutoChild named "uploadItem".  For an overview of how to use and
 configure AutoChildren, see Using AutoChildren.
Upload overview and related methodspublic FileItem setViewIconSrc(java.lang.String viewIconSrc)
viewIconSrc - New viewIconSrc value. Default value is "[SKIN]actions/view.png"FileItem instance, for chaining setter callsSCImgURL, 
Images overview and related methodspublic java.lang.String getViewIconSrc()
SCImgURL, 
Images overview and related methodspublic static void setDefaultProperties(FileItem fileItemProperties)
Note: This method is intended for setting default attributes only and will affect all instances of the underlying class (including those automatically generated in JavaScript). This method should not be used to apply standard EventHandlers or override methods for a class - use a custom subclass instead. Calling this method after instances have been created can result in undefined behavior, since it bypasses any setters and a class instance may have already examined a particular property and not be expecting any changes through this route.
fileItemProperties - properties that should be used as new defaults when instances of this class are createdSGWTProperties