|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectrs.sol.soloist.server.uml.commonimplementation.runtime._ClassifierInstance
rs.sol.soloist.server.uml.commonimplementation.runtime._ClassInstance
rs.sol.soloist.server.javaimpl.runtime.SOLoistClassInstance
rs.sol.soloist.server.builtindomains.common.ObjectOfClass
rs.sol.soloist.server.guiconfiguration.construction.GUIComponent
rs.sol.soloist.server.guiconfiguration.elementcomponents.GUIElementComponent
rs.sol.soloist.server.guiconfiguration.elementcomponents.GUIInput
public class GUIInput
A class that covers a variaty of widgets and input controls
(fields, lists, combo boxes, suggest boxes, trees, and tables) that
serve to help users pick or specify a value or values (both class
or a data type instances) from the domain object space. Values can be either
selected or picked from the provided collection of values, like
selecting a value in a list, or they can be specified by the user, like
typing-in a number in a text box. Non of the values are being submitted
automatically to the object space on the server. This is the main difference
between these types of widgets and those created by using GUIEdit
class which have option to submit selected or specified values to the server
automatically.
The selected or specified values are always provided on the value
output pin (opValue()
method) of this widget, so they can be
sent to other widgets using the widget binding mechanism.
Different types of widgets can be produced using this class, so not all available methods are valid for each type of widget. Each method specifies what types of widgets support it.
GUIElementComponent
Nested Class Summary | |
---|---|
static class |
GUIInput.FQPropertyNames
Deprecated. Not for public use. |
static class |
GUIInput.PROPERTIES
Deprecated. Not for public use. |
Field Summary | |
---|---|
static IClass |
CLASSIFIER
UML class reference |
static java.lang.String |
FQ_TYPE_NAME
Fully qualified UML class name |
Fields inherited from class rs.sol.soloist.server.guiconfiguration.elementcomponents.GUIElementComponent |
---|
clearValue, input, kind, value, widget |
Fields inherited from class rs.sol.soloist.server.guiconfiguration.construction.GUIComponent |
---|
addStyle, context, description, enabled, init, inputBindings, layoutData, logger, name, outputBindings, ownerTable, parent, removeStyle, show, showInParent, styleName, tooltip, visible |
Constructor Summary | |
---|---|
GUIInput()
|
Method Summary | |
---|---|
void |
addColumn(java.lang.String name,
GUIComponent c)
Adds the column header name and the corresponding column component. |
void |
addColumnComponent(GUIComponent c)
Adds the new component to the collection of column components. |
void |
addColumnName(java.lang.String name)
Adds the column name of this table. |
void |
addInitialValue(rs.sol.soloist.server.uml.concepts.IElement el)
Adds the new initial value. |
void |
clearColumnComponents()
Clears the column components collection. |
void |
clearColumnNames()
Clears the column names of this table. |
void |
clearInitialValues()
Clears the initial value collection. |
void |
constructor()
The domain-specific constructor of the Classifier. |
static GUIInput |
createCombo(GUIContainerComponent parent)
Creates a combo widget that presents objects obtained through the widget binding mechanism via the collection input pin
(ipCollection() method). |
static GUIInput |
createCombo(GUIContainerComponent parent,
IProperty property)
Creates a combo widget that presents objects obtained by reading the slot that corresponds to provided property of the domain object obtained through the widget binding mechanism via the element input pin
(ipSlotValueElement() method). |
static GUIInput |
createCombo(GUIContainerComponent parent,
IProperty property,
LayoutData layoutData)
Creates a combo widget that presents objects obtained by reading the slot that corresponds to provided property of the domain object obtained through the widget binding mechanism via the element input pin
(ipSlotValueElement() method), and additionally, sets a specific
layout data information. |
static GUIInput |
createCombo(GUIContainerComponent parent,
LayoutData layoutData)
Creates a combo widget that presents objects obtained through the widget binding mechanism via the collection input pin
(ipCollection() method) and sets a specific layout data
information. |
static GUIInput |
createField(GUIContainerComponent parent,
IDataType dataType)
Creates a field input control depending on a data type provided. |
static GUIInput |
createField(GUIContainerComponent parent,
IDataType dataType,
int row,
int column)
Creates a field input control depending on a data type provided and sets the row and column indices for the target cell in a table. |
static GUIInput |
createField(GUIContainerComponent parent,
IDataType dataType,
LayoutData layoutData)
Creates a field input control depending on a data type provided and sets a specific layout data information. |
static GUIInput |
createList(GUIContainerComponent parent)
Creates a list widget that presents objects obtained through the widget binding mechanism via the collection input pin
(ipCollection() method). |
static GUIInput |
createList(GUIContainerComponent parent,
IProperty property)
Creates a list widget that presents objects obtained by reading the slot that corresponds to provided property of the domain object obtained through the widget binding mechanism via the element input pin
(ipSlotValueElement() method). |
static GUIInput |
createSuggest(GUIContainerComponent parent)
Creates a suggest widget that presents objects obtained through the widget binding mechanism via the collection input pin
(ipCollection() method). |
static GUIInput |
createSuggest(GUIContainerComponent parent,
IProperty property)
Creates a suggest widget that presents objects obtained by reading the slot that corresponds to provided property of the domain object obtained through the widget binding mechanism via the element input pin
(ipSlotValueElement() method). |
static GUIInput |
createSuggest(GUIContainerComponent parent,
IProperty property,
LayoutData layoutData)
Creates a suggest widget that presents objects obtained by reading the slot that corresponds to provided property of the domain object obtained through the widget binding mechanism via the element input pin
(ipSlotValueElement() method), and additionally, sets a specific
layout data information. |
static GUIInput |
createSuggest(GUIContainerComponent parent,
LayoutData layoutData)
Creates a suggest widget that presents objects obtained through the widget binding mechanism via the collection input pin
(ipCollection() method) and sets a specific layout data
information. |
static GUIInput |
createTable(GUIContainerComponent parent)
Creates a table widget that presents objects obtained through the widget binding mechanism via the collection input pin
(ipCollection() method). |
static GUIInput |
createTable(GUIContainerComponent parent,
IProperty property)
Creates a table widget that presents objects obtained by reading the slot that corresponds to provided property of the domain object obtained through the widget binding mechanism via the element input pin
(ipSlotValueElement() method). |
static GUIInput |
createTable(GUIContainerComponent parent,
IProperty property,
java.lang.String... columnLabels)
Creates a table widget that presents objects obtained by reading the slot that corresponds to provided property of the domain object obtained through the widget binding mechanism via the element input pin
(ipSlotValueElement() method), and additionally, sets a column
labels in a table header. |
static GUIInput |
createTable(GUIContainerComponent parent,
java.lang.String... columnLabels)
Creates a table widget that presents objects obtained through the widget binding mechanism via the collection input pin
(ipCollection() method) and sets a column labels in the table
header. |
static GUIInput |
createTree(GUIContainerComponent parent)
Creates a tree widget that presents objects obtained through the widget binding mechanism via the collection input pin
(ipCollection() method). |
static GUIInput |
createTree(GUIContainerComponent parent,
IProperty property)
Creates a tree widget that presents objects obtained by reading the slot that corresponds to provided property of the domain object obtained through the widget binding mechanism via the element input pin
(ipSlotValueElement() method). |
java.lang.String |
getAllowedExtenstions()
Returns allowed extensions. |
boolean |
getAllowFreeText()
Deprecated. Not supported any more. |
java.lang.String |
getCheckBoxLabel()
Returns the check box label. |
java.util.List<GUIComponent> |
getColumnComponents()
Returns the collection of column widgets of this table. |
java.lang.String[] |
getColumnNames()
Returns the column names String array. |
java.lang.String |
getDefaultTime()
Returns the default time. |
boolean |
getDisplayDateAsCalendar()
Returns whether this widget (if it is a configured for the Date or DateTime type) should be displayed as calendar. |
boolean |
getEmptyTextAsNull()
Returns whether empty text is treated as null or as empty String (""). |
boolean |
getHTML()
Returns whether this widget accepts HTML. |
java.util.List<rs.sol.soloist.server.uml.concepts.IElement> |
getInitialValues()
Returns the initial values list. |
int |
getLowerBound()
Returns the lower bound. |
int |
getMaxLength()
Returns the max length in characters that this widget can accept. |
int |
getMinRows()
Returns the minimum number of rows always displayed in a table (if this widget is a table at all). |
boolean |
getMultiline()
Returns whether this widget is displayed as text area. |
boolean |
getPassword()
Returns whether this widget is displayed as password text box. |
java.lang.String |
getRegularExpression()
Returns the regular expression. |
int |
getSelectionLowerBound()
Returns the selection lower bound. |
int |
getSelectionUpperBound()
Returns the selection upper bound. |
boolean |
getShowSuggestionsOnFocus()
Returns whether this widget (is it is a suggest widget) should show suggestions on focus. |
boolean |
getSlotValueIndirect()
Deprecated. Not supported any more. |
java.lang.String |
getSlotValuePropertyFQName()
Returns the slot value property name. |
GUICommandComponent |
getTableTransformer()
Returns the table transformer command widget if it exist and if this widget is a table at all. |
boolean |
getToggle()
Returns whether this widget (if it is configured for the Boolean type) should be displayed as toggle
button instead of as check box. |
java.lang.String |
getTypeFQName()
Returns the type FQ name. |
int |
getUpperBound()
Returns the upper bound. |
ISlot<?> |
ipChecked()
Returns the checked input pin; when event occurs, if this widget
is check box, it will get checked. |
ISlot<?> |
ipClearValue()
Returns the clearValue input pin;
when event occurs, selected, picked, or specified value of this widget
will be cleared. |
ISlot<?> |
ipCollection()
Returns the collection input pin; when event occurs, the
collection of instances from the binding message will be presented in
this widget. |
ISlot<?> |
ipFocus()
Returns the focus input pin; when event occurs, this widget
will receive focus. |
ISlot<?> |
ipRefreshInput()
Returns the refresh input pin; when event occurs,
the presented data will be re-fetched from the server. |
ISlot<?> |
ipReset()
Returns the reset input pin; when event occurs the value
of this widget will be re-set to initial value. |
ISlot<?> |
ipSelectAll()
Returns the selectAll input pin; when event occurs, this
widget will select all objects that are presented at that moment in time. |
ISlot<?> |
ipSelection()
Returns the selection input pin; when event occurs, this
widget will try to select object(s) from the binding message if it/they
is/are presented in this widget. |
ISlot<?> |
ipSlotValueElement()
Returns the slot value element input pin; when event occurs,
the slot value of the object from the binding message will be fetched and
and presented. |
ISlot<?> |
ipSubnodesInput()
Deprecated. Not supported any more. |
ISlot<?> |
ipUnchecked()
Returns the unchecked input pin; when event occurs,
if this widget is check box, it will get unchecked. |
ISlot<?> |
ipUnselectAll()
Returns the unselectAll input pin; when event occurs, this
widget will un-select all selected objects that are presented at that
moment in time. |
ISlot<?> |
ipValue()
Returns the value input pin; when event occurs,
binding message content will be presented, picked or selected by this widget. |
ISlot<?> |
opChecked()
Returns the checked output pin; for every check of the
value of the check box, an empty binding message will be provided on this
pin. |
ISlot<?> |
opEnterPressed()
Returns the enterPressed output pin; when this widget has
focus and enter pressed event is issued, the empty binding message will
be provided on this pin. |
ISlot<?> |
opFocus()
Returns the focus output pin; when this widget receives
focus, the empty binding message will be provided on this pin. |
ISlot<?> |
opFocusLost()
Returns the focusLost output pin; when this widget loses
focus, the empty binding message will be provided on this pin. |
ISlot<?> |
opParent()
Returns the parent output pin; for every change of selection
in a tree, the binding message with the parent object of the newly
selected object will be provided on this pin. |
ISlot<?> |
opSelection()
Returns the selection output pin; for every change of selection the
binding message with selected object(s) will be provided on this pin. |
ISlot<?> |
opUnchecked()
Returns the unchecked output pin; for every un-check of the
value of the check box, an empty binding message will be provided on this
pin. |
ISlot<?> |
opValue()
Returns the value output pin; when the selected, picked,
or typed-in value of this widget changes, the binding message with
that new value will be provided on this pin. |
void |
removeColumnComponent(GUIComponent c)
Removes the component from the collection of column components. |
void |
removeColumnName(java.lang.String name)
Removes the column name of this table. |
void |
removeInitialValue(rs.sol.soloist.server.uml.concepts.IElement el)
Removes one initial value. |
void |
setAllowedExtensions(java.lang.String extensions)
Sets the allowable file extensions if this widget is configured with File or Picture data type. |
void |
setAllowFreeText(boolean value)
Deprecated. Not supported any more. |
void |
setCheckBoxLabel(java.lang.String label)
Sets the check box label if this widget is configured with the Boolean data type and has lower bound set to 1. |
void |
setColumnComponents(GUIComponent... components)
Sets the array of new column widgets. |
void |
setColumnComponents(java.util.List<GUIComponent> components)
Sets the collection of new column widgets. |
void |
setColumnNames(java.lang.String... names)
Sets the column names of this table. |
void |
setDefaultTime(java.lang.String defaultTime)
Sets the default display time if this widget is configured with Time or DataTime data type. |
void |
setDisplayDateAsCalendar(boolean displayAsCalendar)
Sets whether this widget (if it is a configured for the Date or DateTime type) should be displayed as calendar. |
void |
setEmptyTextAsNull(boolean isEmptyTextNull)
Sets whether empty text is treated as null or as empty String (""). |
void |
setHTML(boolean isHTML)
Sets whether this widget should accept HTML text. |
void |
setInitialValues(java.util.List<rs.sol.soloist.server.uml.concepts.IElement> elements)
Sets the initial values. |
void |
setLowerBound(int lowerBound)
Sets the lower bound. |
void |
setMaxLength(int length)
Sets the max acceptable text length. |
void |
setMinRows(int minRows)
Sets the min number of rows always apparent in the table. |
void |
setMultiline(boolean isMultiline)
Sets whether this widget appears as text area. |
void |
setPassword(boolean isPassword)
Sets whether this widget should act as a password text box. |
void |
setRegularExpression(java.lang.String regex)
Sets the regular expression that drives the validation of this widget. |
void |
setSelectionLowerBound(int bound)
Sets the selection lower bound if this widget is a list, tree, or a table version. |
void |
setSelectionUpperBound(int bound)
Sets the selection upper bound if this widget is a list, tree, or a table version. |
void |
setShowSuggestionsOnFocus(boolean show)
Sets whether this widget should show suggestion immediately after receives focus or wait until at least one character is typed-in. |
void |
setSlotValueIndirect(boolean value)
Deprecated. Not supported any more. |
void |
setSlotValuePropertyFQName(java.lang.String fqName)
Sets the property FQ name that determines the slot of the object received via the widget binding mechanism via the slot value element input pin
(ipSlotValueElement() method), which will be used to fetch
objects and present them in this widget. |
void |
setTableTransformer(GUICommandComponent t)
Sets the transformer command widget. |
void |
setToggle(boolean isToggle)
Sets whether this widget should behave like a toggle button. |
void |
setTypeFQName(java.lang.String typeFQName)
Sets the FQ name of the data type according to which this widget should work. |
void |
setUpperBound(int upperBound)
Sets the upper bound. |
Methods inherited from class rs.sol.soloist.server.guiconfiguration.elementcomponents.GUIElementComponent |
---|
addEnumerationInstancesInfo, create, create, create, create, create, create, create, createInput, createInput, createInput, createInput, createInput, createInput, createInput, createInput, createInputCheckbox, createInputCheckbox, createInputTree, createInputTree, createInputTree, createInputTree, createInputTree, createSlotEditor, createSlotEditor, createSlotEditor, createSlotEditor, createSlotEditor, createSlotEditor, createSlotEditor, createSlotEditor, createSlotEditor, createSlotEditor, createSlotEditor, createSlotEditor, createSlotEditorCheckbox, createSlotEditorCheckbox, createSlotEditorTree, getAutoSubmit, getDisplayAsLabel, getIndirect, getIntegralPart, getMaxFileSize, getPartial, getPropertyFQName, getReadOnly, ipElement, ipParent, ipRefresh, ipSubmit, setAutoSubmit, setDisplayAsLabel, setIndirect, setMaxFileSize, setPartial, setPropertyFQName, setReadOnly, validate |
Methods inherited from class rs.sol.soloist.server.javaimpl.runtime.SOLoistClassInstance |
---|
destroy, equals, getAssociationEndInstance, getAssociationEndInstances, getAttributeValue, getAttributeValues, getMyClass, getMyID, getSlot, getSlot, getSlots, getUMLClass, hashCode, isMarkedAsDeleted, toString |
Methods inherited from class rs.sol.soloist.server.uml.commonimplementation.runtime._ClassInstance |
---|
accept, accept, exists, getAssociationEndInstance, getAssociationEndInstance, getAssociationEndInstance, getClassifier, hasIdentity, isClassInstance, isDataTypeInstance, isEqualTo, makeClone, markAsDeleted |
Methods inherited from class rs.sol.soloist.server.uml.commonimplementation.runtime._ClassifierInstance |
---|
conformsTo, copySlots, copySlots, getAttributeValue, getAttributeValue, getAttributeValue, getClassifierFQName, getClassifierUQName, getFirstCommonGeneralizer, getFirstCommonGeneralizerFQName, getFirstCommonGeneralizerUQName, getMElement, getSlot, getSlot, isDirectInstanceOf, isDirectInstanceOf, isInstanceOf, isInstanceOf, isKindOf, isModelElement, isRTElement |
Methods inherited from class java.lang.Object |
---|
getClass, notify, notifyAll, wait, wait, wait |
Methods inherited from interface rs.sol.soloist.server.uml.concepts.runtime.IClassifierInstance |
---|
conformsTo, copySlots, copySlots, getAttributeValue, getAttributeValue, getClassifierFQName, getClassifierUQName, getFirstCommonGeneralizer, getFirstCommonGeneralizerFQName, getFirstCommonGeneralizerUQName, getSlot, getSlot, isDirectInstanceOf, isDirectInstanceOf, isInstanceOf, isInstanceOf |
Methods inherited from interface rs.sol.soloist.server.uml.concepts.runtime.IRTElement |
---|
getMElement |
Methods inherited from interface rs.sol.soloist.server.uml.concepts.IElement |
---|
isKindOf, isModelElement, isRTElement |
Field Detail |
---|
public static final java.lang.String FQ_TYPE_NAME
public static final IClass CLASSIFIER
Constructor Detail |
---|
public GUIInput()
Method Detail |
---|
public void constructor()
IClassifierInstance
constructor
in interface IClassifierInstance
constructor
in class GUIElementComponent
public static GUIInput createField(GUIContainerComponent parent, IDataType dataType)
For example:
Boolean
then a combo box with three
options (empty option, true, and false) is created. To make it appear
as check box, the lower multiplicity must be set to 1 using
setLowerBound(int)
method. The lower (multiplicity) bound means
that it is not acceptable not to pick any value.Text, Integer, Real, Time, TimeInterval
then a text box is created with an appropriate basic validation rules.Date
or DateTime
then a text box
and a date(time) picker are created.
GUIInput input = GUIInput.create(parent, Text.CLASSIFIER); // regular text box
input.setMultiline(true); // this will make it appear as a text area
input.setRegularExpression("^\\(?(\\d{3})\\)?[- ]?(\\d{3})[- ]?(\\d{4})$"); // this will add a phone number validation constraint
GUIInput input = GUIInput.create(parent, Integer.CLASSIFIER); // text box that accepts valid integers
GUIInput input = GUIInput.create(parent, Real.CLASSIFIER); // text box that accepts valid doubles
GUIInput input = GUIInput.create(parent, Boolean.CLASSIFIER); // combo box with empty, true and false values
input.setLowerBound(1); // this will make it appear as check box
input.addInitialValue(Boolean.TRUE); // this will set the true initial value
input.setCheckBoxLabel("Is married?"); // this will add a label
input.setToggle(true); // this will make the check box appear as a toggle button
GUIInput input = GUIInput.create(parent, Date.CLASSIFIER); // text box and a date picker
parent
- the parent GUIContainerComponent
widgetdataType
- the data type whose values should be supported
GUIInput
widgetpublic static GUIInput createField(GUIContainerComponent parent, IDataType dataType, LayoutData layoutData)
createField(GUIContainerComponent, IDataType)
method, plus adds layout specification.
parent
- the parent GUIContainerComponent
widgetdataType
- the data type whose values should be supportedlayoutData
- the LayoutData
of the widget to be created
GUIInput
widgetpublic static GUIInput createField(GUIContainerComponent parent, IDataType dataType, int row, int column)
createField(GUIContainerComponent, IDataType, LayoutData)
method,
but constrained to table layout.
parent
- the parent GUIContainerComponent
widgetdataType
- the data type whose values should be supportedrow
- the row index in a parent table of the widget to be createdcolumn
- the column index in a parent table of the widget to be created
GUIInput
widgetpublic static GUIInput createList(GUIContainerComponent parent)
collection
input pin
(ipCollection()
method).
parent
- the parent GUIContainerComponent
widget
public static GUIInput createList(GUIContainerComponent parent, IProperty property)
element
input pin
(ipSlotValueElement()
method).
parent
- the parent GUIContainerComponent
widgetproperty
- the property whose slot is to be read
public static GUIInput createTree(GUIContainerComponent parent)
collection
input pin
(ipCollection()
method).
parent
- the parent GUIContainerComponent
widget
public static GUIInput createTree(GUIContainerComponent parent, IProperty property)
element
input pin
(ipSlotValueElement()
method).
parent
- the parent GUIContainerComponent
widgetproperty
- the property whose slot is to be read
public static GUIInput createCombo(GUIContainerComponent parent)
collection
input pin
(ipCollection()
method).
parent
- the parent GUIContainerComponent
widget
public static GUIInput createCombo(GUIContainerComponent parent, LayoutData layoutData)
collection
input pin
(ipCollection()
method) and sets a specific layout data
information.
parent
- the parent GUIContainerComponent
widgetlayoutData
- the LayoutData
of the widget to be created
public static GUIInput createCombo(GUIContainerComponent parent, IProperty property)
element
input pin
(ipSlotValueElement()
method).
parent
- the parent GUIContainerComponent
widgetproperty
- the property whose slot is to be read
public static GUIInput createCombo(GUIContainerComponent parent, IProperty property, LayoutData layoutData)
element
input pin
(ipSlotValueElement()
method), and additionally, sets a specific
layout data information.
parent
- the parent GUIContainerComponent
widgetproperty
- the property whose slot is to be readlayoutData
- the LayoutData
of the widget to be created
public static GUIInput createSuggest(GUIContainerComponent parent)
collection
input pin
(ipCollection()
method).
parent
- the parent GUIContainerComponent
widget
public static GUIInput createSuggest(GUIContainerComponent parent, LayoutData layoutData)
collection
input pin
(ipCollection()
method) and sets a specific layout data
information.
parent
- the parent GUIContainerComponent
widgetlayoutData
- the LayoutData
of the widget to be created
public static GUIInput createSuggest(GUIContainerComponent parent, IProperty property)
element
input pin
(ipSlotValueElement()
method).
parent
- the parent GUIContainerComponent
widgetproperty
- the property whose slot is to be read
public static GUIInput createSuggest(GUIContainerComponent parent, IProperty property, LayoutData layoutData)
element
input pin
(ipSlotValueElement()
method), and additionally, sets a specific
layout data information.
parent
- the parent GUIContainerComponent
widgetproperty
- the property whose slot is to be readlayoutData
- the LayoutData
of the widget to be created
public static GUIInput createTable(GUIContainerComponent parent)
collection
input pin
(ipCollection()
method).
parent
- the parent GUIContainerComponent
widget
public static GUIInput createTable(GUIContainerComponent parent, java.lang.String... columnLabels)
collection
input pin
(ipCollection()
method) and sets a column labels in the table
header.
parent
- the parent GUIContainerComponent
widgetcolumnLabels
- the array of column labels to be placed in a table header
public static GUIInput createTable(GUIContainerComponent parent, IProperty property)
element
input pin
(ipSlotValueElement()
method).
parent
- the parent GUIContainerComponent
widgetproperty
- the property whose slot is to be read
public static GUIInput createTable(GUIContainerComponent parent, IProperty property, java.lang.String... columnLabels)
element
input pin
(ipSlotValueElement()
method), and additionally, sets a column
labels in a table header.
parent
- the parent GUIContainerComponent
widgetproperty
- the property whose slot is to be readcolumnLabels
- the array of column labels to be placed in a table header
public ISlot<?> ipValue()
value
input pin; when event occurs,
binding message content will be presented, picked or selected by this widget.
For example, if this widget is a list, and a binding message with the object (contained in the list) is received through this pin, the object will immediately become selected. Or, if this widget is a text box, then each binding message with a text received through this pin will set the text box to that new value (the old value will be cleared).
ipValue
in class GUIElementComponent
value
input pinGUIComponentBinding
public ISlot<?> ipClearValue()
clearValue
input pin;
when event occurs, selected, picked, or specified value of this widget
will be cleared. The binding message content is of no importance.
Only event is what matters.
For example, if this widget is a list, this will clear the selection. If this widget is a text box, it will clear the text in the text box.
ipClearValue
in class GUIElementComponent
clearValue
input pinGUIComponentBinding
public ISlot<?> ipReset()
reset
input pin; when event occurs the value
of this widget will be re-set to initial value. The binding message
content is of no importance. Only event is what matters.
ipReset
in class GUIElementComponent
reset
input pinaddInitialValue(IElement)
,
GUIComponentBinding
public ISlot<?> ipRefreshInput()
refresh
input pin; when event occurs,
the presented data will be re-fetched from the server. The binding message
content is of no importance. Only event is what matters.
This pin is not supported in the field versions of this widget.
ipRefreshInput
in class GUIElementComponent
refresh
input pinGUIComponentBinding
@Deprecated public ISlot<?> ipSubnodesInput()
ipSubnodesInput
in class GUIElementComponent
public ISlot<?> ipCollection()
collection
input pin; when event occurs, the
collection of instances from the binding message will be presented in
this widget. This pin is not supported in the field versions
of this widget.
For example, if this widget is a list and receives a collection of domain object instances via this pin, these instances will be presented.
ipCollection
in class GUIElementComponent
collection
input pinGUIComponentBinding
public ISlot<?> ipSlotValueElement()
element
input pin; when event occurs,
the slot value of the object from the binding message will be fetched and
and presented. The slot value is actually a collection of objects linked to
the object from the binding message. The property of the slot must be defined
during the construction of this widget.
ipSlotValueElement
in class GUIElementComponent
element
input pinGUIComponentBinding
public ISlot<?> ipFocus()
focus
input pin; when event occurs, this widget
will receive focus. The binding message content is of no importance.
Only event is what matters. This pin is supported only in field
versions of this widget.
ipFocus
in class GUIElementComponent
focus
input pinGUIComponentBinding
public ISlot<?> ipChecked()
checked
input pin; when event occurs, if this widget
is check box, it will get checked. The binding message content is of no
importance. This pin is supported only in field version of this widget
configured for Boolean
data type.
ipChecked
in class GUIElementComponent
checked
input pinGUIComponentBinding
public ISlot<?> ipUnchecked()
unchecked
input pin; when event occurs,
if this widget is check box, it will get unchecked.
The binding message content is of no importance. Only event is
what matters. This pin is supported only in field version
of this widget configured for Boolean
data type.
ipUnchecked
in class GUIElementComponent
unchecked
input pinGUIComponentBinding
public ISlot<?> ipSelection()
selection
input pin; when event occurs, this
widget will try to select object(s) from the binding message if it/they
is/are presented in this widget. This pin is supported only in tree, list,
and table versions of this widget.
ipSelection
in class GUIElementComponent
selection
input pinGUIComponentBinding
public ISlot<?> ipSelectAll()
selectAll
input pin; when event occurs, this
widget will select all objects that are presented at that moment in time.
The binding message content is of no importance.
Only event is what matters. This pin is supported only
in tree, list, and table versions of this widget.
ipSelectAll
in class GUIElementComponent
selectAll
input pinGUIComponentBinding
public ISlot<?> ipUnselectAll()
unselectAll
input pin; when event occurs, this
widget will un-select all selected objects that are presented at that
moment in time. The binding message content is of no importance.
Only event is what matters. This pin is supported only in tree,
list, and table versions of this widget.
ipUnselectAll
in class GUIElementComponent
unselectAll
input pinGUIComponentBinding
public ISlot<?> opParent()
parent
output pin; for every change of selection
in a tree, the binding message with the parent object of the newly
selected object will be provided on this pin. This pin is supported
only in tree version of this widget.
parent
output pinGUIComponentBinding
public ISlot<?> opSelection()
selection
output pin; for every change of selection the
binding message with selected object(s) will be provided on this pin.
This pin is supported only in tree, list, and table versions of this widget.
opSelection
in class GUIElementComponent
selection
output pinGUIComponentBinding
public ISlot<?> opUnchecked()
unchecked
output pin; for every un-check of the
value of the check box, an empty binding message will be provided on this
pin. This pin is only supported in the field version of this widget
configured for Boolean
data type.
opUnchecked
in class GUIElementComponent
unchecked
output pinGUIComponentBinding
public ISlot<?> opChecked()
checked
output pin; for every check of the
value of the check box, an empty binding message will be provided on this
pin. This pin is only supported in the field version of this widget
configured for Boolean
data type.
opChecked
in class GUIElementComponent
checked
output pinGUIComponentBinding
public ISlot<?> opFocus()
focus
output pin; when this widget receives
focus, the empty binding message will be provided on this pin. This pin
is only supported in field versions of this widget.
opFocus
in class GUIElementComponent
focus
output pinGUIComponentBinding
public ISlot<?> opFocusLost()
focusLost
output pin; when this widget loses
focus, the empty binding message will be provided on this pin. This pin
is only supported in field versions of this widget.
opFocusLost
in class GUIElementComponent
focusLost
output pinGUIComponentBinding
public ISlot<?> opEnterPressed()
enterPressed
output pin; when this widget has
focus and enter pressed event is issued, the empty binding message will
be provided on this pin. This pin is only supported in field versions of this widget.
opEnterPressed
in class GUIElementComponent
enterPressed
output pinGUIComponentBinding
public ISlot<?> opValue()
value
output pin; when the selected, picked,
or typed-in value of this widget changes, the binding message with
that new value will be provided on this pin.
opValue
in class GUIElementComponent
value
output pinGUIComponentBinding
public int getLowerBound()
getLowerBound
in class GUIElementComponent
setLowerBound(int)
public void setLowerBound(int lowerBound)
For example, the combo box with lower bound 0 would present an empty option in the list options. The same combo box with lower bound 1 would not present it however. The list of objects with lower bound 0, would allow not selecting any objects, but if the lower bound is 1, then at least one object must always be selected in the list.
setLowerBound
in class GUIElementComponent
lowerBound
- the new lower bound. Default is 0.setUpperBound(int)
public int getUpperBound()
getUpperBound
in class GUIElementComponent
setUpperBound(int)
public void setUpperBound(int upperBound)
For example, if the list of objects has upper bound 1 then only one object can be selected at the time.
setUpperBound
in class GUIElementComponent
upperBound
- the new upper bound. Default is 1. Infinitely is -1.setLowerBound(int)
public java.lang.String getSlotValuePropertyFQName()
getSlotValuePropertyFQName
in class GUIElementComponent
setSlotValuePropertyFQName(String)
public void setSlotValuePropertyFQName(java.lang.String fqName)
element
input pin
(ipSlotValueElement()
method), which will be used to fetch
objects and present them in this widget. This method should not be called
for field version of this widget; only for list, tree, combo, suggest,
and table versions.
setSlotValuePropertyFQName
in class GUIElementComponent
fqName
- the FQ name of the slot@Deprecated public boolean getSlotValueIndirect()
getSlotValueIndirect
in class GUIElementComponent
@Deprecated public void setSlotValueIndirect(boolean value)
setSlotValueIndirect
in class GUIElementComponent
public java.lang.String getTypeFQName()
getTypeFQName
in class GUIElementComponent
setTypeFQName(String)
public void setTypeFQName(java.lang.String typeFQName)
For example, if this method is called with Text.FQ_TYPE_NAME as a parameter, then this widget will appear as a text box for accepting text values.
setTypeFQName
in class GUIElementComponent
typeFQName
- the data type FQ namepublic java.lang.String getCheckBoxLabel()
getCheckBoxLabel
in class GUIElementComponent
setCheckBoxLabel(String)
public void setCheckBoxLabel(java.lang.String label)
Boolean
data type and has lower bound set to 1.
setCheckBoxLabel
in class GUIElementComponent
label
- the new check box labelpublic java.lang.String getDefaultTime()
getDefaultTime
in class GUIElementComponent
setDefaultTime(String)
public void setDefaultTime(java.lang.String defaultTime)
Time
or DataTime
data type.
setDefaultTime
in class GUIElementComponent
defaultTime
- the default time. Default is 12:00.public java.lang.String getAllowedExtenstions()
getAllowedExtenstions
in class GUIElementComponent
setAllowedExtensions(String)
public void setAllowedExtensions(java.lang.String extensions)
File
or Picture
data type.
setAllowedExtensions
in class GUIElementComponent
extensions
- the allowable file extensionspublic java.lang.String getRegularExpression()
getRegularExpression
in class GUIElementComponent
setRegularExpression(String)
public void setRegularExpression(java.lang.String regex)
setRegularExpression
in class GUIElementComponent
regex
- the regular expression that drives the validationpublic boolean getMultiline()
getMultiline
in class GUIElementComponent
setMultiline(boolean)
public void setMultiline(boolean isMultiline)
Text
data type.
setMultiline
in class GUIElementComponent
isMultiline
- the boolean that tells whether this widget appears as
text areapublic boolean getPassword()
getPassword
in class GUIElementComponent
setPassword(boolean)
public void setPassword(boolean isPassword)
setPassword
in class GUIElementComponent
isPassword
- the boolean that tells whether this widget should
act as a password text boxpublic boolean getEmptyTextAsNull()
String
("").
getEmptyTextAsNull
in class GUIElementComponent
String
("")setEmptyTextAsNull(boolean)
public void setEmptyTextAsNull(boolean isEmptyTextNull)
String
(""). Relevant only in the field version
of this widget configured with Text
data type.
setEmptyTextAsNull
in class GUIElementComponent
isEmptyTextNull
- the boolean that tells whether empty text is
treated as null or as empty String
("")public boolean getDisplayDateAsCalendar()
Date
or DateTime
type) should be displayed as calendar.
getDisplayDateAsCalendar
in class GUIElementComponent
setDisplayDateAsCalendar(boolean)
public void setDisplayDateAsCalendar(boolean displayAsCalendar)
Date
or DateTime
type) should be displayed as calendar.
setDisplayDateAsCalendar
in class GUIElementComponent
displayAsCalendar
- the boolean that tells whether this widget
should be displayed as calendarpublic boolean getHTML()
getHTML
in class GUIElementComponent
setHTML(boolean)
public void setHTML(boolean isHTML)
Text
data type.
setHTML
in class GUIElementComponent
isHTML
- the boolean that tells whether this widget should
accept HTML textpublic int getMaxLength()
getMaxLength
in class GUIElementComponent
setMaxLength(int)
public void setMaxLength(int length)
setMaxLength
in class GUIElementComponent
length
- the max acceptable text lengthpublic int getSelectionLowerBound()
getSelectionLowerBound
in class GUIElementComponent
setSelectionLowerBound(int)
public void setSelectionLowerBound(int bound)
setSelectionLowerBound
in class GUIElementComponent
bound
- the selection lower boundpublic int getSelectionUpperBound()
getSelectionUpperBound
in class GUIElementComponent
setSelectionUpperBound(int)
public void setSelectionUpperBound(int bound)
setSelectionUpperBound
in class GUIElementComponent
bound
- the selection upper boundpublic boolean getToggle()
Boolean
type) should be displayed as toggle
button instead of as check box.
getToggle
in class GUIElementComponent
setToggle(boolean)
public void setToggle(boolean isToggle)
Boolean
data type.
setToggle
in class GUIElementComponent
isToggle
- the boolean that tell whether this widget should behave
like the toggle button@Deprecated public boolean getAllowFreeText()
getAllowFreeText
in class GUIElementComponent
@Deprecated public void setAllowFreeText(boolean value)
setAllowFreeText
in class GUIElementComponent
public boolean getShowSuggestionsOnFocus()
getShowSuggestionsOnFocus
in class GUIElementComponent
setShowSuggestionsOnFocus(boolean)
public void setShowSuggestionsOnFocus(boolean show)
setShowSuggestionsOnFocus
in class GUIElementComponent
show
- the boolean that tells whether this widget should
show suggestion immediately after receives focus or wait until
at least one character is typed-inpublic int getMinRows()
getMinRows
in class GUIElementComponent
setMinRows(int)
public void setMinRows(int minRows)
setMinRows
in class GUIElementComponent
minRows
- the number of rows always apparent in the tablepublic GUICommandComponent getTableTransformer()
getTableTransformer
in class GUIElementComponent
setTableTransformer(GUICommandComponent)
,
GUICommandComponent
public void setTableTransformer(GUICommandComponent t)
setTableTransformer
in class GUIElementComponent
t
- the transformer command widgetGUICommandComponent
public java.lang.String[] getColumnNames()
String
array. This is relevant only
if this widget is a table.
getColumnNames
in class GUIElementComponent
public void setColumnNames(java.lang.String... names)
setColumnNames
in class GUIElementComponent
names
- the column names of this tablepublic void addColumnName(java.lang.String name)
addColumnName
in class GUIElementComponent
name
- the column name to be addedpublic void removeColumnName(java.lang.String name)
removeColumnName
in class GUIElementComponent
name
- the column name to be removedpublic void clearColumnNames()
clearColumnNames
in class GUIElementComponent
public java.util.List<rs.sol.soloist.server.uml.concepts.IElement> getInitialValues()
getInitialValues
in class GUIElementComponent
public void setInitialValues(java.util.List<rs.sol.soloist.server.uml.concepts.IElement> elements)
setInitialValues
in class GUIElementComponent
elements
- the new list of initial valuespublic void addInitialValue(rs.sol.soloist.server.uml.concepts.IElement el)
addInitialValue
in class GUIElementComponent
el
- the new initial value to be addedpublic void removeInitialValue(rs.sol.soloist.server.uml.concepts.IElement el)
removeInitialValue
in class GUIElementComponent
el
- the initial value to be removedpublic void clearInitialValues()
clearInitialValues
in class GUIElementComponent
public java.util.List<GUIComponent> getColumnComponents()
getColumnComponents
in class GUIElementComponent
public void setColumnComponents(java.util.List<GUIComponent> components)
setColumnComponents
in class GUIElementComponent
components
- the collection of new column componentspublic void setColumnComponents(GUIComponent... components)
setColumnComponents
in class GUIElementComponent
components
- the array of new column componentspublic void addColumnComponent(GUIComponent c)
addColumnComponent
in class GUIElementComponent
c
- the new component (widget) to be addedpublic void removeColumnComponent(GUIComponent c)
removeColumnComponent
in class GUIElementComponent
c
- the component (widget) to be removedpublic void clearColumnComponents()
clearColumnComponents
in class GUIElementComponent
public void addColumn(java.lang.String name, GUIComponent c)
addColumn
in class GUIElementComponent
name
- the column header namec
- the column component
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |