e4s.html.input.extended
Class FILESELECTION

java.lang.Object
  e4s.util.E4Object
      e4s.html.E4HtmlObject
          e4s.html.E4HtmlElementGeneral
              e4s.html.input.extended.E4FieldsetLayout
                  e4s.html.input.extended.E4InputField
                      e4s.html.input.extended.TEXTFIELD
                          e4s.html.input.extended.FILESELECTION

All Implemented Interfaces:

E4FieldsetLayout_Intf, E4HtmlElement_Intf, E4InputField_Intf

Direct Known Subclasses:

IMAGEFIELD

public class FILESELECTION
extends TEXTFIELD
implements E4InputField_Intf

A textinput field that is intended for filenames, plus a file selection pickup dialog.

Example_FILESELECTION.java

Since:

JDK 1.4

See Also:

E4ModuleFileselection

Nested Class Summary

static class

FILESELECTION.E4ExceptionInstanciate Error when instanciating a class.

Nested classes/interfaces inherited from class e4s.html.input.extended.E4InputField

E4InputField.A_PICK

Field Summary

static int

DEFAULT_INPUT_LENGTH Default input length for the HTML input form.

Fields inherited from class e4s.html.input.extended.TEXTFIELD

m_displaylength, m_inputlength, m_uppercase

Fields inherited from class e4s.html.input.extended.E4InputField

BGCOLOR_READONLY, HTML_TAG, m_helpid, m_label, m_multiple_tablerows_id, m_name, m_pickup_ref, m_readonly, m_show_label, m_style_active, m_style_inactive, m_validation_object, m_validationmessage, m_value, m_visible, ms_help_image, PICKUP_IMAGE_NAME_PREFIX

Fields inherited from class e4s.html.E4HtmlElementGeneral

m_elements, m_needed_scripts

Fields inherited from class e4s.html.E4HtmlObject

m_parent_e4sID

Fields inherited from class e4s.util.E4Object

CRLF, E4S_CORE_SYSTEM_LANGUAGE, NBSP, NULLSTR, URL_ENCODING_CHARSET

Constructor Summary

FILESELECTION(E4DBColumnInfo colinf, E4Label_Intf label)

FILESELECTION(E4DBColumnInfo colinf, java.lang.String label)

FILESELECTION(E4ID parent_id, E4InputFieldName_Intf name, E4Label_Intf label)

FILESELECTION(E4ID parent_id, E4InputFieldName_Intf name, E4Label_Intf label, int displaylength)

FILESELECTION(E4ID parent_id, E4InputFieldName_Intf name, E4Label_Intf label, int displaylength, int inputlength)

FILESELECTION(E4ID parent_id, E4InputFieldName_Intf name, java.lang.String label)

FILESELECTION(E4ID parent_id, E4InputFieldName_Intf name, java.lang.String label, int displaylength)

FILESELECTION(E4InputFieldName_Intf name, E4Label_Intf label)

FILESELECTION(E4InputFieldName_Intf name, E4Label_Intf label, int displaylength)

FILESELECTION(E4InputFieldName_Intf name, E4Label_Intf label, int displaylength, int inputlength)

FILESELECTION(E4InputFieldName_Intf name, java.lang.String label)

FILESELECTION(E4InputFieldName_Intf name, java.lang.String label, int displaylength)

FILESELECTION(FILESELECTION field)

Method Summary

protected A_FORM	definePickupList(E4ServletImplementation_Intf servlet, E4JavaScript js, int selection_mode)
protected A_FORM	definePickupList(E4ServletImplementation_Intf servlet, E4JavaScript js, int selection_mode, boolean resize_uses_client, int resize_width, int resize_height)
E4InputField_Intf	duplicate() Get the status of enabling the selection of directories.
boolean	getCanDeleteFiles() Status of deleting files.
boolean	getCanUploadFiles() Status of uploading files.
java.lang.String	getE4SRootPath()
java.lang.String[]	getExtensionsAllowed()
java.lang.String[]	getFileExtensions() Deprecated.
java.lang.String	getInitPath() Get the initial path.
int	getMaxUploadSize() Get the maximum upload size defined.
void	setCanDeleteFiles(boolean mode) Enables deletion of files (by default this is turned off).
void	setCanDeleteFiles(java.lang.Class clazz) Enables deletion of files and involves an AEP function.
void	setCanUploadFiles(boolean mode) Enables upload of files.
void	setE4SRootPath(java.lang.String relative_path) Define the root path for E4S environment (non client) selection of the image pickup.
void	setExtensionsAllowed(java.lang.String[] extensions)
void	setFileExtensions(java.lang.String extensions) Deprecated.
void	setFileExtensions(java.lang.String[] extensions) Deprecated.
void	setInitPath(java.lang.String path) Define the initial path.
void	setLimitPath(java.lang.String path) Define a path limitation, each path can be seperated by comma.
void	setMaxUploadSize(int size) Define maximum upload size.
void	toHtml(E4StringBufferHtml buf, E4ServletImplementation_Intf servlet) Create the HTML output for this element.

Methods inherited from class e4s.html.input.extended.TEXTFIELD

_getSVNVersionString, addAjaxChanger, getLengthDisplay, getLengthMaxInput, getValue_native, getValue, setToUppercase

Methods inherited from class e4s.html.input.extended.E4InputField

addElement, AppendValidationE4Message, changeColumnName, collectStylesForEditing, collectTranslationsForEditing, debugToString, definePickupList, definePickupList, definePickupList, definePickupList, definePickupList, definePickupList, definePickupList, display_simpleReport, E4ID, equalsIgnoreCase, eventHandlers, getCanChangeLayout, getColumnName, getErrorMessage, getEventHandlers, getHelpId, getHtmlParamName, getLabel, getMultipleTablerowsId, getPersistant, getPersistantLayout, getPickupList, getReadOnly, getSTYLE, getSTYLE, getValidator, hideLabel, HtmlEncode, isHiddenField, isMandatory, isVisible, onChange, onChange, onChange, onClick, removePickupList, resetValidation, setCanChangeLayout, setErrorMessage, setErrorMessage, setEventHandler, setHelpId, setHelpImage, setLabel, setMultipleTablerowsId, setReadOnly, setReadOnly, setReadOnly, setSTYLE, setSTYLE, setValidation, setValidator, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setVisible, toHIDDENFIELD, toHtml_drawSimpleReport, toHtml_drawSimpleReport, toHtml_drawSimpleReport, toHtml_hidden, toHtml, toString, updatePersistantLayout, validate, validate, validate

Methods inherited from class e4s.html.input.extended.E4FieldsetLayout

isNextRow, layoutToNextRow

Methods inherited from class e4s.html.E4HtmlElementGeneral

addScript, addScript, addScript, addStyleForEditing, addTranslationForEditing, buildStyleAttribute, buildStyleClassReference, collectScripts, collectStylesForEditing, collectStylesForEditing, collectTranslationsForEditing, createScript, createScript, findElement, findElement, findElement, findElement, getElements, getElementsVec, getField, getId, getLastElement, getStringContent, getStyle, getStyle, hasScripts, hasSTYLE, isContentClass, isE4InputField_Intf, openTag, removeAll, removeElementById, removeElements, removeElements, removeStyle, setId, setStyle, setStyle, setSTYLE, Style, Style

Methods inherited from class e4s.html.E4HtmlObject

E4ID, set_e4sID

Methods inherited from class e4s.util.E4Object

Calendar, CName, CName, E4LabelApp, E4LabelApp, E4LabelApp, E4LabelApp, E4LabelApp, E4LabelApp, E4LabelNone, E4LabelNone, E4LabelNone, E4LabelNone, E4LabelSys, E4LabelSys, e4sCopyright, e4sVersion, encode, encode, encode, encodeHtml, encodeHtml, encodeHtml, encodeURL, encodeURL, encodeURL, finalize, getLINE, getTRACE, getTRACE, getTRACE, getTRACE, getTRACE, getTRACE, getTraceMemory, HtmlEncode, HtmlEncode, isdecimal, isdigit, isnotok, isnotok, isnumeric, isok, isok, isok, isok, lastCallingFunction, lastCallingFunction, lastCallingFunction, lastCallingFunction, lastCallingStack, mkdirs, null2nbsp, null2nbsp, null2nbsp, ok, ok, ok, ok, outPrintln, setLogFile4Trace, setTraceMemory, STACKTRACE, toDebug, toDouble, toFloat, toFloat, TRACE_CALLS, TRACE, TRACE, TRACE, TRACE, TRACE, TRACE, TRACE, TRACE, TRACE, TRACE, TRACE, TRACE, wait

Methods inherited from class java.lang.Object

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

Methods inherited from interface e4s.html.input.extended.E4InputField_Intf

changeColumnName, definePickupList, definePickupList, display_simpleReport, equalsIgnoreCase, eventHandlers, getCanChangeLayout, getColumnName, getErrorMessage, getHtmlParamName, getLabel, getMultipleTablerowsId, getPickupList, getReadOnly, getValue_native, hideLabel, isHiddenField, isMandatory, isVisible, resetValidation, setCanChangeLayout, setErrorMessage, setErrorMessage, setEventHandler, setHelpId, setLabel, setMultipleTablerowsId, setReadOnly, setReadOnly, setValidator, setValue, setValue, setValue, setValue, setValue, setVisible, toHIDDENFIELD, toHtml_drawSimpleReport, toHtml_drawSimpleReport, validate, validate

Methods inherited from interface e4s.html.E4FieldsetLayout_Intf

isNextRow, layoutToNextRow

Methods inherited from interface e4s.html.E4HtmlElement_Intf

addScript, addScript, addScript, collectScripts, collectStylesForEditing, collectTranslationsForEditing, debugToString, findElement, findElement, getElements, getElementsVec, getField, getId, getStringContent, isContentClass, removeAll, removeElementById, removeElements, set_e4sID, setId, toHtml_hidden, validate

Field Detail

DEFAULT_INPUT_LENGTH

public static final int DEFAULT_INPUT_LENGTH

Default input length for the HTML input form.

See Also:

Constant Field Values

Constructor Detail

FILESELECTION

public FILESELECTION(FILESELECTION field)

FILESELECTION

public FILESELECTION(E4ID parent_id,
                     E4InputFieldName_Intf name,
                     java.lang.String label,
                     int displaylength)

FILESELECTION

public FILESELECTION(E4ID parent_id,
                     E4InputFieldName_Intf name,
                     E4Label_Intf label,
                     int displaylength)

FILESELECTION

public FILESELECTION(E4ID parent_id,
                     E4InputFieldName_Intf name,
                     E4Label_Intf label,
                     int displaylength,
                     int inputlength)

FILESELECTION

public FILESELECTION(E4ID parent_id,
                     E4InputFieldName_Intf name,
                     java.lang.String label)

FILESELECTION

public FILESELECTION(E4ID parent_id,
                     E4InputFieldName_Intf name,
                     E4Label_Intf label)

FILESELECTION

public FILESELECTION(E4InputFieldName_Intf name,
                     java.lang.String label,
                     int displaylength)

FILESELECTION

public FILESELECTION(E4InputFieldName_Intf name,
                     E4Label_Intf label,
                     int displaylength)

FILESELECTION

public FILESELECTION(E4InputFieldName_Intf name,
                     E4Label_Intf label,
                     int displaylength,
                     int inputlength)

FILESELECTION

public FILESELECTION(E4InputFieldName_Intf name,
                     java.lang.String label)

FILESELECTION

public FILESELECTION(E4DBColumnInfo colinf,
                     E4Label_Intf label)

FILESELECTION

public FILESELECTION(E4DBColumnInfo colinf,
                     java.lang.String label)

FILESELECTION

public FILESELECTION(E4InputFieldName_Intf name,
                     E4Label_Intf label)

Method Detail

setFileExtensions

public void setFileExtensions(java.lang.String[] extensions)

Deprecated.

See Also:

#setExtensionsAllowed(String[]))

setFileExtensions

public void setFileExtensions(java.lang.String extensions)

Deprecated.

See Also:

#setExtensionsAllowed(String[]))

setExtensionsAllowed

public void setExtensionsAllowed(java.lang.String[] extensions)

getFileExtensions

public java.lang.String[] getFileExtensions()

Deprecated.

See Also:

getExtensionsAllowed()

getExtensionsAllowed

public java.lang.String[] getExtensionsAllowed()

definePickupList

protected A_FORM definePickupList(E4ServletImplementation_Intf servlet,
                                  E4JavaScript js,
                                  int selection_mode)
                           throws java.lang.Exception

Throws:

java.lang.Exception

definePickupList

protected A_FORM definePickupList(E4ServletImplementation_Intf servlet,
                                  E4JavaScript js,
                                  int selection_mode,
                                  boolean resize_uses_client,
                                  int resize_width,
                                  int resize_height)
                           throws java.lang.Exception

Throws:

java.lang.Exception

toHtml

public void toHtml(E4StringBufferHtml buf,
                   E4ServletImplementation_Intf servlet)
            throws java.lang.Exception

Description copied from interface: E4HtmlElement_Intf

Create the HTML output for this element. Also run throught all child elements, and call their E4HtmlElement_Intf.toHtml(e4s.util.E4StringBufferHtml, e4s.servlet.E4ServletImplementation_Intf) function to generate output of those objects which becomes appended. Normally, there is no need to call this function anyway, and this also might result in side effects of too-early relasing of objects in some cases. This function is called by E4ServletImplementation_Intf.write(e4s.html.E4HtmlElement) on the top level HTML element (common this is a HTML or BODY element) and branches down to all child elements.

Specified by:

toHtml in interface E4HtmlElement_Intf

Specified by:

toHtml in interface E4InputField_Intf

Overrides:

toHtml in class TEXTFIELD

servlet - the servlet environment currently running in

Throws:

java.lang.Exception

setMaxUploadSize

public void setMaxUploadSize(int size)

Define maximum upload size. Requires upload enabled (setCanUploadFiles(boolean). A value of -1 disables a specific upload size and uses E4Settings.getMaxUploadSize().

Parameters:

size - the maximum number of bytes to upload, a value less or equal than 0 means no restriction in size which leads to E4Settings.getMaxUploadSize().

See Also:

getMaxUploadSize(), E4Settings.getMaxUploadSize()

getMaxUploadSize

public int getMaxUploadSize()

Get the maximum upload size defined.

See Also:

setMaxUploadSize(int), E4Settings.getMaxUploadSize()

setCanUploadFiles

public void setCanUploadFiles(boolean mode)

Enables upload of files.

Parameters:

mode - the mode for uploading files (true = enabled)

See Also:

FILEUPLOAD, getCanUploadFiles(), E4ModuleFileselection.PARAM_CAN_UPLOAD

setCanDeleteFiles

public void setCanDeleteFiles(boolean mode)

Enables deletion of files (by default this is turned off).

Parameters:

mode - the mode for uploading files (true = enabled)

See Also:

FILEUPLOAD, getCanDeleteFiles(), E4ModuleFileselection.PARAM_CAN_DELETE, E4ModuleFileselection.PARAM_AEP_DELETE

setCanDeleteFiles

public void setCanDeleteFiles(java.lang.Class clazz)
                       throws E4Exception

Enables deletion of files and involves an AEP function.

Parameters:

mode - the mode for uploading files (true = enabled)

Throws:

E4Exception

See Also:

FILEUPLOAD, getCanDeleteFiles(), E4ModuleFileselection.PARAM_CAN_DELETE, E4ModuleFileselection.PARAM_AEP_DELETE

getCanUploadFiles

public boolean getCanUploadFiles()

Status of uploading files.

Returns:

the mode for uploading files (true = enabled)

See Also:

setCanUploadFiles(boolean)

getCanDeleteFiles

public boolean getCanDeleteFiles()

Status of deleting files.

Returns:

the mode for uploading files (true = enabled)

See Also:

setCanUploadFiles(boolean)

duplicate

public E4InputField_Intf duplicate()

Get the status of enabling the selection of directories.

Specified by:

duplicate in interface E4InputField_Intf

Overrides:

duplicate in class TEXTFIELD

Returns:

the mode for choosing directories (faöse = disables = default)

See Also:

#setCanChooseDirectory(boolean), ./ public boolean getCanChooseDirectory() { return m_Can_ChooseDirectory; }

setInitPath

public void setInitPath(java.lang.String path)

Define the initial path. Use relative path values.

Parameters:

path - the path

See Also:

E4ModuleFileselection.PARAM_INIT_PATH, getInitPath(), setLimitPath(String)

setLimitPath

public void setLimitPath(java.lang.String path)

Define a path limitation, each path can be seperated by comma. This only allows the user to select files within this given path region. Use relative path values.

Parameters:

path - the path

See Also:

E4ModuleFileselection.PARAM_LIMIT_PATH, #getLimitPath(), setInitPath(String)

getInitPath

public java.lang.String getInitPath()

Get the initial path.

Returns:

the path

See Also:

e4s.application.sysmodule.E4ModuleFileselection2#PARAM_INIT_PATH, setInitPath(String)

setE4SRootPath

public void setE4SRootPath(java.lang.String relative_path)

Define the root path for E4S environment (non client) selection of the image pickup. Use this function carefully, use setInitPath(String) in other cases. If this value is not set, then a E4Client related path will be used to distinct images from different clients.

See Also:

e4s.html.editing.E4EditingDataDescriptor#setE4SRootPath(), e4s.util.E4Settings#getDocumentBase(), getE4SRootPath(), #setInitPath()

getE4SRootPath

public java.lang.String getE4SRootPath()