com.uc4.api.prompt

Class TextElement

java.lang.Object

com.uc4.api.objects.PromptElement

com.uc4.api.prompt.OnChangeResetElement

com.uc4.api.prompt.TextElement

All Implemented Interfaces:

PromptInterfaces.Caption, PromptInterfaces.DataReference, PromptInterfaces.Focus, PromptInterfaces.Locked, PromptInterfaces.MultiSelect, PromptInterfaces.QuoteCharacter, PromptInterfaces.ValueRequired, PromptInterfaces.XmlKey, PromptInterfaces.XPath

public class TextElement
extends OnChangeResetElement
implements PromptInterfaces.Caption, PromptInterfaces.Focus, PromptInterfaces.MultiSelect, PromptInterfaces.XmlKey, PromptInterfaces.XPath, PromptInterfaces.ValueRequired, PromptInterfaces.QuoteCharacter, PromptInterfaces.Locked, PromptInterfaces.DataReference

A prompt element of type text.

Constructor Summary

Constructors

Constructor and Description
TextElement(String variableName, UC4ObjectName reference)

Method Summary

Modifier and Type	Method and Description
String	getCaption()
UC4ObjectName	getDataReference()
int	getMaxLength()
String	getMultiSelectSeparator() Returns the mulit select separator character.
char	getQuoteCharacter() Returns the character for a quote.
String	getRegExp() Returns the Regular expression or an empty String if not set.
String	getXmlKey() Returns the key for XML Variables in the data reference.
String	getXPath() Returns the XPath expression if XML variables are used as data reference.
boolean	hasFocus() Returns true if the focus is set.
boolean	hasInputAssistance()
boolean	hasMultiSelect()
boolean	isLocked() Returns true if this Prompt Element is locked.
boolean	isMultiline() Returns the value of the multi-line property.
boolean	isShowAsPassword() If set, this control shows asterisks instead of the text which was entered.
boolean	isUpper() Returns true if the values should be converted to upper case.
boolean	isValueRequired() Returns true if the user has to use the default value or enter a value in this field.
void	setCaption(String caption) Sets the caption of this prompt element.
void	setDataReference(UC4ObjectName vara) Sets a UC4 VARA Object which contains a list of valid entries for this prompt element.
void	setFocus(boolean value) Sets the cursor focus: The cursor is placed at this control if the value is true.
void	setInputAssistance(boolean value) Enables or disables the input assistance for this field.
void	setLocked(boolean locked) Lock or unlocks this element.
void	setMaxLength(int length) Sets the maximal length for inputs in this text field.
void	setMultiline(boolean value) Enables or disables the multiline property.
void	setMultiSelect(boolean value) Enables or disables multi select.
void	setMultiSelectSeparator(String sep) Sets the mulit select separator character.
void	setQuoteCharacter(char c) Sets the character for a quote, for example ' or ".
void	setRegExp(String regex) Sets the Regular expression.
void	setShowAsPassword(boolean value) If set, this control shows asterisks instead of the text which was entered.
void	setUpper(boolean value) Sets the upper cause property.
void	setValueRequired(boolean value) Sets or clears the property which determines if this field requires a value.
void	setXmlKey(String key) Sets the key in case XML Variables are used as data reference.
void	setXPath(String xpath) Sets the XPath expression if XML variables are used as data reference.

Methods inherited from class com.uc4.api.prompt.OnChangeResetElement

addOnChangeResetElement, getAllOnChangeResetElementIterator, onChangeResetElementIterator, removeAllOnChangeResetElements, removeOnChangeResetElement, resetAllSubValues, sizeOfOnChangeResetElements

Methods inherited from class com.uc4.api.objects.PromptElement

getCustomField, getMessageInsert, getMessageNumber, getProperty, getTooltip, getValue, getValues, getVariable, hasList, isAltView, setAltView, setCustomField, setTooltip, setValue, setValues, setVariable, toString, updateDefaultValue

Methods inherited from class java.lang.Object

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

Constructor Detail

TextElement

public TextElement(String variableName,
                   UC4ObjectName reference)

Parameters:

variableName - Name of the script variable

reference - Reference

Method Detail

setXmlKey

public void setXmlKey(String key)

Sets the key in case XML Variables are used as data reference.

Specified by:

setXmlKey in interface PromptInterfaces.XmlKey

Parameters:

key - Key

getXmlKey

public String getXmlKey()

Returns the key for XML Variables in the data reference.

Specified by:

getXmlKey in interface PromptInterfaces.XmlKey

Returns:

Key or an empty String if not set.

setXPath

public void setXPath(String xpath)

Sets the XPath expression if XML variables are used as data reference.

Specified by:

setXPath in interface PromptInterfaces.XPath

Parameters:

xpath - XPath/Query expression

getXPath

public String getXPath()

Returns the XPath expression if XML variables are used as data reference.

Specified by:

getXPath in interface PromptInterfaces.XPath

Returns:

XPath/Query expression or an empty String if not set.

isLocked

public boolean isLocked()

Returns true if this Prompt Element is locked. In this case a user cannot change the default value in the Prompt-Screen.

Specified by:

isLocked in interface PromptInterfaces.Locked

Returns:

true if locked, false if the user can change the value of the Prompt Element

setQuoteCharacter

public void setQuoteCharacter(char c)

Sets the character for a quote, for example ' or ".

Specified by:

setQuoteCharacter in interface PromptInterfaces.QuoteCharacter

Parameters:

c - Character

getQuoteCharacter

public char getQuoteCharacter()

Returns the character for a quote.

Specified by:

getQuoteCharacter in interface PromptInterfaces.QuoteCharacter

Returns:

for example ' or "

setLocked

public void setLocked(boolean locked)

Lock or unlocks this element. A user cannot change the default value in the Prompt-Screen if a control is locked.

Specified by:

setLocked in interface PromptInterfaces.Locked

Parameters:

locked - true if locked, false if the user can change the value of the Prompt Element

setRegExp

public void setRegExp(String regex)

Sets the Regular expression.

Parameters:

regex - Regular expression

getRegExp

public String getRegExp()

Returns the Regular expression or an empty String if not set.

Returns:

Regular expression

hasFocus

public boolean hasFocus()

Returns true if the focus is set. The cursor is placed at this control if the value is true. It may only be defined for one control in the PromptSet. If this flag is defined for several Controls of a PromptSet the last Control that got the flag wins.

Specified by:

hasFocus in interface PromptInterfaces.Focus

Returns:

true if the cursor should be set in this Prompt Element, false otherwise

setFocus

public void setFocus(boolean value)

Sets the cursor focus: The cursor is placed at this control if the value is true. It may only be defined for one control in the PromptSet. If this flag is defined for several Controls of a PromptSet the last Control that got the flag wins.

Specified by:

setFocus in interface PromptInterfaces.Focus

Parameters:

value - true if the cursor should be set in this Prompt Element, false otherwise

isUpper

public boolean isUpper()

Returns true if the values should be converted to upper case.

Returns:

true if uppercase

setUpper

public void setUpper(boolean value)

Sets the upper cause property.

Parameters:

value - true to enable the conversion to upper case, false to disable it

isShowAsPassword

public boolean isShowAsPassword()

If set, this control shows asterisks instead of the text which was entered.

Returns:

true if enabled, false if disabled

setShowAsPassword

public void setShowAsPassword(boolean value)

If set, this control shows asterisks instead of the text which was entered.

Parameters:

value - true to enable the password field, false to disable it

isValueRequired

public boolean isValueRequired()

Returns true if the user has to use the default value or enter a value in this field.

Specified by:

isValueRequired in interface PromptInterfaces.ValueRequired

Returns:

true if a value is required, false otherwise

setValueRequired

public void setValueRequired(boolean value)

Sets or clears the property which determines if this field requires a value.

Specified by:

setValueRequired in interface PromptInterfaces.ValueRequired

Parameters:

value - true if a value is required, false otherwise

hasInputAssistance

public boolean hasInputAssistance()

Returns:

true if input assistance is enabled, false otherwise

setInputAssistance

public void setInputAssistance(boolean value)

Enables or disables the input assistance for this field.

Parameters:

value - true if input assistance should be enabled, false otherwise

getCaption

public String getCaption()

Specified by:

getCaption in interface PromptInterfaces.Caption

Returns:

Caption of this prompt element

setCaption

public void setCaption(String caption)

Sets the caption of this prompt element.

Specified by:

setCaption in interface PromptInterfaces.Caption

Parameters:

caption - Caption

setDataReference

public void setDataReference(UC4ObjectName vara)

Sets a UC4 VARA Object which contains a list of valid entries for this prompt element.

Specified by:

setDataReference in interface PromptInterfaces.DataReference

Parameters:

vara - Name of a Variable Object

getDataReference

public UC4ObjectName getDataReference()

Specified by:

getDataReference in interface PromptInterfaces.DataReference

Returns:

Name of a Variable Object

setMultiSelect

public void setMultiSelect(boolean value)

Enables or disables multi select.

Specified by:

setMultiSelect in interface PromptInterfaces.MultiSelect

Parameters:

value - true if mulit select should be enabled

hasMultiSelect

public boolean hasMultiSelect()

Specified by:

hasMultiSelect in interface PromptInterfaces.MultiSelect

Returns:

true if multi select is enabled

setMultiline

public void setMultiline(boolean value)

Enables or disables the multiline property.

Parameters:

value - true if this text field should contain more than one line, false if not.

isMultiline

public boolean isMultiline()

Returns the value of the multi-line property.

Returns:

true if this text control supports more than one line of data.

setMultiSelectSeparator

public void setMultiSelectSeparator(String sep)

Sets the mulit select separator character.

Specified by:

setMultiSelectSeparator in interface PromptInterfaces.MultiSelect

Parameters:

sep - separator character

getMultiSelectSeparator

public String getMultiSelectSeparator()

Returns the mulit select separator character.

Specified by:

getMultiSelectSeparator in interface PromptInterfaces.MultiSelect

Returns:

separator character

setMaxLength

public void setMaxLength(int length)

Sets the maximal length for inputs in this text field.

Parameters:

length - Max length

getMaxLength

public int getMaxLength()

Returns:

Maximum length which is allowed in this text field.