e4s.html.input.extended
Class SELECT

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.SELECT

All Implemented Interfaces:

E4FieldsetLayout_Intf, E4HtmlElement_Intf, E4InputField_Intf

public class SELECT
extends E4InputField
implements E4InputField_Intf

An input field (for <FORM>) elements representing a selection (<SELECT> / <OPTION>) value.

Example_InputForm.java

Example_DIV_3.java

Since:

JDK 1.4

See Also:

FORM, CountryCode.getCountrySelection(), Language.getLanguageSelection()

Nested Class Summary

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

E4InputField.A_PICK

Field Summary

static java.lang.String	HTML_TAG
static E4JavaScriptReference	JS_SELECT This is the Java-Script that is required for some special manipulations on SELECT fields.

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

BGCOLOR_READONLY, 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

SELECT(E4ID parent_id, E4InputFieldName_Intf name, E4Label_Intf label, E4SelectValues selection)
Construct an input field for an selection (SELECT, OPTION).

SELECT(E4ID parent_id, E4InputFieldName_Intf name, E4Label_Intf label, E4SelectValuesFieldDependent selection)

SELECT(E4ID parent_id, E4InputFieldName_Intf name, E4Label_Intf label, java.lang.String[] selection)
Construct a input field for an selection (SELECT, OPTION).

SELECT(E4ID parent_id, E4InputFieldName_Intf name, E4Label_Intf label, java.util.Vector selection)

SELECT(E4ID parent_id, E4InputFieldName_Intf name, java.lang.String label, E4SelectValues selection)
Construct an input field for an selection (SELECT, OPTION).

SELECT(E4ID parent_id, E4InputFieldName_Intf name, java.lang.String label, E4SelectValuesFieldDependent selection)

SELECT(E4ID parent_id, E4InputFieldName_Intf name, java.lang.String label, java.lang.String[] selection)
Construct a input field for an selection (SELECT, OPTION).

SELECT(E4ID parent_id, E4InputFieldName_Intf name, java.lang.String label, java.util.Vector selection)
Deprecated.

SELECT(E4InputFieldName_Intf name, E4Label_Intf label, E4SelectValues selection)
Construct an input field for an selection (SELECT, OPTION).

SELECT(E4InputFieldName_Intf name, E4Label_Intf label, E4SelectValuesFieldDependent selection)

SELECT(E4InputFieldName_Intf name, E4SelectValues selection)
Construct an input field for an selection (SELECT, OPTION) without a label.

SELECT(E4InputFieldName_Intf name, java.lang.String label, E4SelectValues selection)
Construct an input field for an selection (SELECT, OPTION).

SELECT(E4InputFieldName_Intf name, java.lang.String label, E4SelectValuesFieldDependent selection)

SELECT(SELECT field)

Method Summary

static java.lang.String	_getSVNVersionString() Get version info string from subversion.
E4AjaxElementSelectOptionsChanger	addAjaxChangerOption(FORM form, E4AjaxData_Intf worker, E4ServletImplementation_Intf servlet) Add an AjaxElement to the field that can change the options visible in the form.
E4AjaxElementInputValueChanger	addAjaxChangerValue(FORM form, E4AjaxData_Intf worker, E4ServletImplementation_Intf servlet) Add an AjaxElement to the field that can change the value visible in the form.
void	collectScripts(E4ScriptsVec v, E4ServletImplementation_Intf servlet) Get a vector of used scripts from all subelements.
void	collectStylesForEditing(E4StylesHash v, E4ServletImplementation_Intf servlet) Internal use only - collect all style elements of this and sun elements.
void	collectTranslationsForEditing(E4TranslationsVec translations, E4ServletImplementation_Intf servlet) Build a list (Vector) with translation texts used so far during display of this page.
E4InputField_Intf	duplicate()
E4JavaScript	getEditingInputScript() This creates a E4JavaScript which improves the input behavior of the SELECT field.
E4JavaScript	getEditingResetScript() This creates a E4JavaScript which improves the input behavior of the SELECT field.
E4InputFieldName_Intf	getRelatedField() If the selection is a related selection, this means that the selection value changes anytime another field is changes, get the name of the related (other) field.
E4SelectValues	getSelection() Get the selection.
E4SelectValuesFieldDependent	getSelectionDependent() Get the selection.
boolean	getSpecialInputBehavior() Checks if special input behaviour is on or off.
java.lang.String	getValue() Get the value of this selection input item.
static E4SelectValues.OPTION	newOption(boolean option, E4Label_Intf display) For convinience: create a new OPTION object (which is a inner class and sometimes difficult and ugly to access)
static E4SelectValues.OPTION	newOption(boolean option, java.lang.String display) For convinience: create a new OPTION object (which is a inner class and sometimes difficult and ugly to access)
static E4SelectValues.OPTION	newOption(char option, E4Label_Intf display) For convinience: create a new OPTION object (which is a inner class and sometimes difficult and ugly to access)
static E4SelectValues.OPTION	newOption(char option, java.lang.String display) For convinience: create a new OPTION object (which is a inner class and sometimes difficult and ugly to access)
static E4SelectValues.OPTION	newOption(E4Long option, E4Label_Intf display) For convinience: create a new OPTION object (which is a inner class and sometimes difficult and ugly to access)
static E4SelectValues.OPTION	newOption(E4Long option, java.lang.String display) For convinience: create a new OPTION object (which is a inner class and sometimes difficult and ugly to access)
static E4SelectValues.OPTION	newOption(E4String option) For convinience: create a new OPTION object (which is a inner class and sometimes difficult and ugly to access)
static E4SelectValues.OPTION	newOption(E4String option, E4Label_Intf display) For convinience: create a new OPTION object (which is a inner class and sometimes difficult and ugly to access)
static E4SelectValues.OPTION	newOption(E4String option, java.lang.String display) For convinience: create a new OPTION object (which is a inner class and sometimes difficult and ugly to access)
static E4SelectValues.OPTION	newOption(long option, E4Label_Intf display) For convinience: create a new OPTION object (which is a inner class and sometimes difficult and ugly to access)
static E4SelectValues.OPTION	newOption(long option, E4String display) For convinience: create a new OPTION object (which is a inner class and sometimes difficult and ugly to access)
static E4SelectValues.OPTION	newOption(long option, java.lang.String display) For convinience: create a new OPTION object (which is a inner class and sometimes difficult and ugly to access)
static E4SelectValues.OPTION	newOption(java.lang.String option) For convinience: create a new OPTION object (which is a inner class and sometimes difficult and ugly to access)
static E4SelectValues.OPTION	newOption(java.lang.String option, E4Label_Intf display) For convinience: create a new OPTION object (which is a inner class and sometimes difficult and ugly to access)
static E4SelectValues.OPTION	newOption(java.lang.String option, E4String display) For convinience: create a new OPTION object (which is a inner class and sometimes difficult and ugly to access)
static E4SelectValues.OPTION	newOption(java.lang.String option, java.lang.String display) For convinience: create a new OPTION object (which is a inner class and sometimes difficult and ugly to access)
void	replaceOptions(E4SelectValues selection) Replaces an existing options Vector, by default uses the default value if specified in the selection.
void	replaceOptions(E4SelectValues selection, boolean force_default_value) Replaces an existing options Vector
void	replaceOptions(E4SelectValuesFieldDependent selection) Replaces an existing options Vector.
void	setSpecialInputBehavior(FORM form) This turns special input behaviour on/off.
void	setSTYLE(CLASS_Name class_name) Set the style for the input field.
void	toHtml(E4StringBufferHtml buf, E4ServletImplementation_Intf servlet) Create the HTML output for this element.
static E4SelectValues	yes_no_Selection() Create a selection for yes/no decisions.

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

addElement, AppendValidationE4Message, changeColumnName, 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, getValue_native, hideLabel, HtmlEncode, isHiddenField, isMandatory, isVisible, onChange, onChange, onChange, onClick, removePickupList, resetValidation, setCanChangeLayout, setErrorMessage, setErrorMessage, setEventHandler, setHelpId, setHelpImage, setLabel, setMultipleTablerowsId, setReadOnly, setReadOnly, setReadOnly, 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, 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, debugToString, findElement, findElement, getElements, getElementsVec, getField, getId, getStringContent, isContentClass, removeAll, removeElementById, removeElements, set_e4sID, setId, toHtml_hidden, validate

Field Detail

HTML_TAG

public static final java.lang.String HTML_TAG

See Also:

Constant Field Values

JS_SELECT

public static E4JavaScriptReference JS_SELECT

This is the Java-Script that is required for some special manipulations on SELECT fields.

Constructor Detail

SELECT

public SELECT(E4ID parent_id,
              E4InputFieldName_Intf name,
              java.lang.String label,
              java.util.Vector selection)

Deprecated.

See Also:

SELECT( e4s.util.E4ID, e4s.html.input.extended.E4InputFieldName_Intf, String, e4s.html.input.extended.E4SelectValues )

SELECT

public SELECT(E4ID parent_id,
              E4InputFieldName_Intf name,
              java.lang.String label,
              E4SelectValues selection)

Construct an input field for an selection (SELECT, OPTION).

Parameters:

name - HTML (CGI) name of the input field. The input field is treatened by this name, and a value can be retrieved throught the E4CgiParams class using this name.

label - E4Label to be displayed on the screen during input

selection - This Vector of objects from type OPTION is used to display the different options for the list. Each option consists of two values: the option value itself, and [optional] a different String for display purposes. The class OPTION is a inner class defined here.

See Also:

#SELECT(String, String, String[])

SELECT

public SELECT(E4InputFieldName_Intf name,
              java.lang.String label,
              E4SelectValues selection)

Construct an input field for an selection (SELECT, OPTION).

Parameters:

name - HTML (CGI) name of the input field. The input field is treatened by this name, and a value can be retrieved throught the E4CgiParams class using this name.

label - E4Label to be displayed on the screen during input

selection - This Vector of objects from type OPTION is used to display the different options for the list. Each option consists of two values: the option value itself, and [optional] a different String for display purposes. The class OPTION is a inner class defined here.

See Also:

#SELECT(String, String, String[])

SELECT

public SELECT(E4InputFieldName_Intf name,
              E4SelectValues selection)

Construct an input field for an selection (SELECT, OPTION) without a label.

Parameters:

name - HTML (CGI) name of the input field. The input field is treatened by this name, and a value can be retrieved throught the E4CgiParams class using this name.

selection - This Vector of objects from type OPTION is used to display the different options for the list. Each option consists of two values: the option value itself, and [optional] a different String for display purposes. The class OPTION is a inner class defined here.

See Also:

#SELECT(String, String, String[])

SELECT

public SELECT(E4ID parent_id,
              E4InputFieldName_Intf name,
              E4Label_Intf label,
              java.util.Vector selection)

See Also:

SELECT( e4s.util.E4ID, e4s.html.input.extended.E4InputFieldName_Intf, e4s.translate.E4Label_Intf, e4s.html.input.extended.E4SelectValues )

SELECT

public SELECT(E4ID parent_id,
              E4InputFieldName_Intf name,
              E4Label_Intf label,
              E4SelectValues selection)

Construct an input field for an selection (SELECT, OPTION).

Parameters:

name - HTML (CGI) name of the input field. The input field is treatened by this name, and a value can be retrieved throught the E4CgiParams class using this name.

label - E4Label to be displayed on the screen during input

selection - This Vector of objects from type OPTION is used to display the different options for the list. Each option consists of two values: the option value itself, and [optional] a different String for display purposes. The class OPTION is a inner class defined here.

See Also:

#SELECT(String, String, String[])

SELECT

public SELECT(E4InputFieldName_Intf name,
              E4Label_Intf label,
              E4SelectValues selection)

Construct an input field for an selection (SELECT, OPTION).

Parameters:

name - HTML (CGI) name of the input field. The input field is treatened by this name, and a value can be retrieved throught the E4CgiParams class using this name.

label - E4Label to be displayed on the screen during input

selection - This Vector of objects from type OPTION is used to display the different options for the list. Each option consists of two values: the option value itself, and [optional] a different String for display purposes. The class OPTION is a inner class defined here.

See Also:

#SELECT(String, String, String[])

SELECT

public SELECT(E4ID parent_id,
              E4InputFieldName_Intf name,
              E4Label_Intf label,
              E4SelectValuesFieldDependent selection)

SELECT

public SELECT(E4ID parent_id,
              E4InputFieldName_Intf name,
              java.lang.String label,
              E4SelectValuesFieldDependent selection)

SELECT

public SELECT(E4InputFieldName_Intf name,
              java.lang.String label,
              E4SelectValuesFieldDependent selection)

SELECT

public SELECT(E4InputFieldName_Intf name,
              E4Label_Intf label,
              E4SelectValuesFieldDependent selection)

SELECT

public SELECT(E4ID parent_id,
              E4InputFieldName_Intf name,
              java.lang.String label,
              java.lang.String[] selection)

Construct a input field for an selection (SELECT, OPTION).

Parameters:

name - HTML (CGI) name of the input field. The input field is treatened by this name, and a value can be retrieved throught the E4CgiParams class using this name.

label - E4Label to be displayed on the screen during input

selection - This is a simple array of selection values for the option tag. Each value is used for display and the value of the selection.

See Also:

#SELECT(String, String, Vector)

SELECT

public SELECT(E4ID parent_id,
              E4InputFieldName_Intf name,
              E4Label_Intf label,
              java.lang.String[] selection)

Construct a input field for an selection (SELECT, OPTION).

Parameters:

name - HTML (CGI) name of the input field. The input field is treatened by this name, and a value can be retrieved throught the E4CgiParams class using this name.

label - E4Label to be displayed on the screen during input

selection - This is a simple array of selection values for the option tag. Each value is used for display and the value of the selection.

See Also:

#SELECT(String, String, Vector)

SELECT

public SELECT(SELECT field)

Method Detail

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 E4HtmlElementGeneral

servlet - the servlet environment currently running in

Throws:

java.lang.Exception

getValue

public java.lang.String getValue()

Get the value of this selection input item.

Returns:

the value

See Also:

E4InputField.setValue(java.lang.String)

newOption

public static E4SelectValues.OPTION newOption(java.lang.String option,
                                              java.lang.String display)

For convinience: create a new OPTION object (which is a inner class and sometimes difficult and ugly to access)

Parameters:

option - is the value associated with the field value (internally)

display - is the label that is shown on the screen and present for the user

Returns:

a new OPTION object

See Also:

newOption(String), E4SelectValues.addElement(String,String)

newOption

public static E4SelectValues.OPTION newOption(java.lang.String option,
                                              E4Label_Intf display)

For convinience: create a new OPTION object (which is a inner class and sometimes difficult and ugly to access)

Parameters:

option - is the value associated with the field value (internally)

display - is the label that is shown on the screen and present for the user

Returns:

a new OPTION object

See Also:

newOption(String), E4SelectValues.addElement(String,e4s.translate.E4Label_Intf)

newOption

public static E4SelectValues.OPTION newOption(char option,
                                              java.lang.String display)

For convinience: create a new OPTION object (which is a inner class and sometimes difficult and ugly to access)

Parameters:

option - is the value associated with the field value (internally)

display - is the label that is shown on the screen and present for the user

Returns:

a new OPTION object

See Also:

newOption(String), E4SelectValues.addElement(e4s.html.input.extended.E4SelectValues.OPTION)

newOption

public static E4SelectValues.OPTION newOption(char option,
                                              E4Label_Intf display)

For convinience: create a new OPTION object (which is a inner class and sometimes difficult and ugly to access)

Parameters:

option - is the value associated with the field value (internally)

display - is the label that is shown on the screen and present for the user

Returns:

a new OPTION object

See Also:

newOption(String), E4SelectValues.addElement(e4s.html.input.extended.E4SelectValues.OPTION)

newOption

public static E4SelectValues.OPTION newOption(E4String option,
                                              java.lang.String display)

For convinience: create a new OPTION object (which is a inner class and sometimes difficult and ugly to access)

Parameters:

option - is the value associated with the field value (internally)

display - is the label that is shown on the screen and present for the user

Returns:

a new OPTION object

See Also:

newOption(String), E4SelectValues.addElement(e4s.html.input.extended.E4SelectValues.OPTION)

newOption

public static E4SelectValues.OPTION newOption(E4String option,
                                              E4Label_Intf display)

For convinience: create a new OPTION object (which is a inner class and sometimes difficult and ugly to access)

Parameters:

option - is the value associated with the field value (internally)

display - is the label that is shown on the screen and present for the user

Returns:

a new OPTION object

See Also:

newOption(String), E4SelectValues.addElement(e4s.html.input.extended.E4SelectValues.OPTION)

newOption

public static E4SelectValues.OPTION newOption(E4Long option,
                                              java.lang.String display)

For convinience: create a new OPTION object (which is a inner class and sometimes difficult and ugly to access)

Parameters:

option - is the value associated with the field value (internally)

display - is the label that is shown on the screen and present for the user

Returns:

a new OPTION object

See Also:

newOption(String), E4SelectValues.addElement(e4s.html.input.extended.E4SelectValues.OPTION)

newOption

public static E4SelectValues.OPTION newOption(E4Long option,
                                              E4Label_Intf display)

For convinience: create a new OPTION object (which is a inner class and sometimes difficult and ugly to access)

Parameters:

option - is the value associated with the field value (internally)

display - is the label that is shown on the screen and present for the user

Returns:

a new OPTION object

See Also:

newOption(String), E4SelectValues.addElement(e4s.html.input.extended.E4SelectValues.OPTION)

newOption

public static E4SelectValues.OPTION newOption(long option,
                                              java.lang.String display)

For convinience: create a new OPTION object (which is a inner class and sometimes difficult and ugly to access)

Parameters:

option - is the value associated with the field value (internally)

display - is the label that is shown on the screen and present for the user

Returns:

a new OPTION object

See Also:

newOption(String), E4SelectValues.addElement(long,String)

newOption

public static E4SelectValues.OPTION newOption(boolean option,
                                              java.lang.String display)

For convinience: create a new OPTION object (which is a inner class and sometimes difficult and ugly to access)

Parameters:

option - is the value associated with the field value (internally)

display - is the label that is shown on the screen and present for the user

Returns:

a new OPTION object

See Also:

newOption(String), E4SelectValues.addElement(boolean,String)

newOption

public static E4SelectValues.OPTION newOption(boolean option,
                                              E4Label_Intf display)

For convinience: create a new OPTION object (which is a inner class and sometimes difficult and ugly to access)

Parameters:

option - is the value associated with the field value (internally)

display - is the label that is shown on the screen and present for the user

Returns:

a new OPTION object

See Also:

newOption(String), E4SelectValues.addElement(boolean,e4s.translate.E4Label_Intf)

newOption

public static E4SelectValues.OPTION newOption(long option,
                                              E4Label_Intf display)

For convinience: create a new OPTION object (which is a inner class and sometimes difficult and ugly to access)

Parameters:

option - is the value associated with the field value (internally)

display - is the label that is shown on the screen and present for the user

Returns:

a new OPTION object

See Also:

newOption(String), E4SelectValues.addElement(e4s.html.input.extended.E4SelectValues.OPTION)

newOption

public static E4SelectValues.OPTION newOption(java.lang.String option,
                                              E4String display)

For convinience: create a new OPTION object (which is a inner class and sometimes difficult and ugly to access)

Parameters:

option - is the value associated with the field value (internally)

display - is the label that is shown on the screen and present for the user

Returns:

a new OPTION object

See Also:

newOption(String), E4SelectValues.addElement(e4s.html.input.extended.E4SelectValues.OPTION)

newOption

public static E4SelectValues.OPTION newOption(long option,
                                              E4String display)

For convinience: create a new OPTION object (which is a inner class and sometimes difficult and ugly to access)

Parameters:

option - is the value associated with the field value (internally)

display - is the label that is shown on the screen and present for the user

Returns:

a new OPTION object

See Also:

newOption(String), E4SelectValues.addElement(e4s.html.input.extended.E4SelectValues.OPTION)

newOption

public static E4SelectValues.OPTION newOption(java.lang.String option)

For convinience: create a new OPTION object (which is a inner class and sometimes difficult and ugly to access)

Parameters:

option - is the value associated with the field value and display

Returns:

a new OPTION object

See Also:

newOption(String, String), E4SelectValues.addElement(String)

newOption

public static E4SelectValues.OPTION newOption(E4String option)

For convinience: create a new OPTION object (which is a inner class and sometimes difficult and ugly to access)

Parameters:

option - is the value associated with the field value and display

Returns:

a new OPTION object

See Also:

newOption(String, String), E4SelectValues.addElement(e4s.util.E4String)

yes_no_Selection

public static E4SelectValues yes_no_Selection()

Create a selection for yes/no decisions.

Returns:

a Vector of type OPTION

setSTYLE

public void setSTYLE(CLASS_Name class_name)

Description copied from class: E4InputField

Set the style for the input field. Note, that an input field can be disabled (E4InputField.getReadOnly() and therefore, two styles (classes) are required: one for the active case and one for the in-active (disabled) case. This function sets both classes, so disabling the field would make no visual difference for the display GUI.

Overrides:

setSTYLE in class E4InputField

See Also:

E4InputField.setSTYLE( e4s.html.style.CLASS_Name, e4s.html.style.CLASS_Name ), E4InputField.getSTYLE()

collectScripts

public void collectScripts(E4ScriptsVec v,
                           E4ServletImplementation_Intf servlet)

Description copied from class: E4HtmlElementGeneral

Get a vector of used scripts from all subelements.

Specified by:

collectScripts in interface E4HtmlElement_Intf

Overrides:

collectScripts in class E4HtmlElementGeneral

Parameters:

v - collect the names of all scripts

servlet - the servlet context

See Also:

E4JavaScript

getEditingInputScript

public E4JavaScript getEditingInputScript()

This creates a E4JavaScript which improves the input behavior of the SELECT field. Requires functionality within external JS_SELECT.

Returns:

a E4JavaScript

See Also:

JS_SELECT, getSpecialInputBehavior()

getEditingResetScript

public E4JavaScript getEditingResetScript()

This creates a E4JavaScript which improves the input behavior of the SELECT field. Requires functionality within external JS_SELECT.

Returns:

a E4JavaScript

See Also:

JS_SELECT, getSpecialInputBehavior()

collectTranslationsForEditing

public void collectTranslationsForEditing(E4TranslationsVec translations,
                                          E4ServletImplementation_Intf servlet)

Description copied from class: E4HtmlElementGeneral

Build a list (Vector) with translation texts used so far during display of this page. Run throught all subclasses elements and collect their texts as well. Note, that a text will only be added one time. The Vector contains elements of class E4Label.

Specified by:

collectTranslationsForEditing in interface E4HtmlElement_Intf

Overrides:

collectTranslationsForEditing in class E4InputField

Parameters:

translations - the Vector where the styles will be collected, may not be null

servlet - the current servlet instance

See Also:

E4Label_Intf

getRelatedField

public E4InputFieldName_Intf getRelatedField()

If the selection is a related selection, this means that the selection value changes anytime another field is changes, get the name of the related (other) field.

Returns:

null if not a related selection or the name of the related field.

See Also:

E4SelectValuesFieldDependent.getRelatedField()

replaceOptions

public void replaceOptions(E4SelectValues selection)

Replaces an existing options Vector, by default uses the default value if specified in the selection.

Parameters:

selection - a Vector of OPTION elements

replaceOptions

public void replaceOptions(E4SelectValues selection,
                           boolean force_default_value)

Replaces an existing options Vector

Parameters:

selection - a Vector of OPTION elements

force_default_value - if true and the selection has a default value (E4SelectValues.getDefaultValue(), then this value is set as the current field value using E4InputField.setValue(String).

replaceOptions

public void replaceOptions(E4SelectValuesFieldDependent selection)

Replaces an existing options Vector.

Parameters:

selection - the new selection

duplicate

public E4InputField_Intf duplicate()

Specified by:

duplicate in interface E4InputField_Intf

setSpecialInputBehavior

public void setSpecialInputBehavior(FORM form)

This turns special input behaviour on/off.

See Also:

JS_SELECT, getEditingInputScript(), getSpecialInputBehavior()

getSpecialInputBehavior

public boolean getSpecialInputBehavior()

Checks if special input behaviour is on or off.

See Also:

JS_SELECT, getEditingInputScript(), setSpecialInputBehavior(e4s.html.FORM)

collectStylesForEditing

public void collectStylesForEditing(E4StylesHash v,
                                    E4ServletImplementation_Intf servlet)

Description copied from class: E4InputField

Internal use only - collect all style elements of this and sun elements.

Specified by:

collectStylesForEditing in interface E4HtmlElement_Intf

Overrides:

collectStylesForEditing in class E4InputField

Parameters:

v - the Vector where the styles are collected

servlet - the servlet context

See Also:

E4ServletImplementation_Intf.sessionCanEditStyles(), #collectStylesForEditing(e4s.html.style.E4StylesHash, STYLE_Name, boolean)

addAjaxChangerValue

public E4AjaxElementInputValueChanger addAjaxChangerValue(FORM form,
                                                          E4AjaxData_Intf worker,
                                                          E4ServletImplementation_Intf servlet)

Add an AjaxElement to the field that can change the value visible in the form.

Parameters:

form - the form where the field belongs to (important for the identification of the form by its name)

worker - the ajax element doing the output, output must be pure text only without any tags

servlet - the actual servlet contect

Returns:

the new created and added ajax element

See Also:

addAjaxChangerOption(e4s.html.FORM, e4s.html.ajax.E4AjaxData_Intf, e4s.servlet.E4ServletImplementation_Intf)

addAjaxChangerOption

public E4AjaxElementSelectOptionsChanger addAjaxChangerOption(FORM form,
                                                              E4AjaxData_Intf worker,
                                                              E4ServletImplementation_Intf servlet)

Add an AjaxElement to the field that can change the options visible in the form.

Parameters:

form - the form where the field belongs to (important for the identification of the form by its name)

worker - the ajax element doing the output, output must be pure text only without any tags

servlet - the actual servlet contect

Returns:

the new created and added ajax element

See Also:

addAjaxChangerValue(e4s.html.FORM, e4s.html.ajax.E4AjaxData_Intf, e4s.servlet.E4ServletImplementation_Intf)

getSelection

public E4SelectValues getSelection()

Get the selection.

Returns:

null if no selection or a field-dependent selection is beeing used

See Also:

getSelectionDependent(), replaceOptions(e4s.html.input.extended.E4SelectValues)

getSelectionDependent

public E4SelectValuesFieldDependent getSelectionDependent()

Get the selection.

Returns:

null if no selection or a non field-dependent selection is beeing used

See Also:

getSelection()

_getSVNVersionString

public static java.lang.String _getSVNVersionString()

Get version info string from subversion.

Returns:

the version info string.

See Also:

E4Util.getRevisionCodeFromSVN(Class)