public class SelectionListWidget extends ControlSetEntity<SelectionListConfig> implements ScrollbarVerticalElement, ScrollbarHorizontalElement, SelectionListInterface, SortedElement, InnerLines, NumItems, Multiple
ControlSetEntity.BiPredicate<T,U>
BaseEntity.CharsPixels
COMPARE_LABEL, COMPARE_LABEL_IGNORE_CASE, COMPARE_VALUE_IGNORE_CASE, LTRIM, RTRIM
ALIGN_COLON, ALIGN_LEFT, ALIGN_RIGHT
group
config, deleted, frame, internalScreenValueUsage, realizeOnAttributeAccess
name, nextSibling, prevSibling
instProc
Constructor and Description |
---|
SelectionListWidget()
Default constructor.
|
SelectionListWidget(boolean dynamic)
Default constructor.
|
Modifier and Type | Method and Description |
---|---|
logical |
delete(character itemList)
Implements the DELETE() widget method, which removes the list item or
items specified.
|
logical |
delete(java.lang.String itemList)
Implements the DELETE() widget method, which removes the list item or
items specified.
|
character |
getFormat()
Gets the format specification.
|
decimal |
getHeightChars()
Gets the HEIGHT-CHARS writable attribute.
|
integer |
getInnerChars()
Gets the value of the INNER-CHARS attribute which defines the number of character
columns in the widget.
|
integer |
getInnerLines()
Gets the value of the INNER-LINES attribute which defines the number of text lines
in the widget.
|
integer |
getNumItems()
Get the NUM-ITEMS attribute.
|
character |
getScreenValue()
Obtain the current value in the screen buffer of the backing data for
this widget and return it as a
character type. |
(package private) character |
getScreenValue(boolean initialized,
BaseDataType bdt,
java.lang.String fmt,
boolean ignoreFormat)
Internal worker for getting the SCREEN-VALUE on a per-widget basis.
|
handle |
getSideLabelHandle()
Obtains the text widget that is used as the side label for this widget.
|
protected void |
getSizeAttrs(java.util.List<java.lang.String> names,
java.util.List<java.lang.Object> vals)
Collect the size-related attributes which can be assigned by this widget.
|
decimal |
getWidthChars()
Gets the WIDTH-CHARS writable attribute.
|
boolean |
hasFormat()
Checks if the given widget has valid format string or even has the format attribute.
|
logical |
isMultiple()
Getter for the MULTIPLE read-only attribute.
|
logical |
isScrollbarHorizontal()
Get the value of the SCROLLBAR-HORIZONTAL attribute which controls whether the widget must
draw the horizontal scroll-bar if the inner width is more than the visible width.
|
logical |
isScrollbarVertical()
Checks whether the selection list must draw the vertical scroll-bar if
the inner size is more than visible one.
|
logical |
isSelected(character item)
Implements the IS-SELECTED() widget method.
|
private boolean |
isSelected(int index)
Helper methods with common selected index lookup code.
|
logical |
isSelected(int64 index)
Implements the IS-SELECTED() widget method.
|
protected boolean |
isValidScreenValue(character value)
Check if the tested value is valid for screen-value.
|
logical |
scrollToItem(character name)
Implements the SCROLL-TO-ITEM() widget method.
|
logical |
scrollToItem(int index)
Implements the SCROLL-TO-ITEM() widget method.
|
logical |
scrollToItem(NumberType index)
Implements the SCROLL-TO-ITEM() widget method.
|
logical |
scrollToItem(java.lang.String name)
Implements the SCROLL-TO-ITEM() widget method.
|
private boolean |
scrollToItemInt(int index)
Internal worker for the SCROLL-TO-ITEM() widget method implementation.
|
void |
setDataType(character dataType)
Sets new value of DATA-TYPE attribute.
|
void |
setDataType(java.lang.String dataType)
Sets new value of DATA-TYPE attribute.
|
void |
setFormat(java.lang.String format)
Sets the format specification.
|
void |
setFrame(FrameWidget frame)
Sets the containing frame instance.
|
void |
setInitialInnerLines(double lines)
Sets the value of the INNER-LINES attribute which defines the number of text lines
in the widget.
|
void |
setInnerChars(double chars)
Sets the value of the INNER-CHARS attribute which defines the number of character
columns in the widget.
|
void |
setInnerChars(NumberType chars)
Sets the value of the INNER-CHARS attribute which defines the number of character
columns in the widget.
|
void |
setInnerLines(double lines)
Sets the value of the INNER-LINES attribute which defines the number of text lines
in the widget.
|
void |
setInnerLines(NumberType lines)
Sets the value of the INNER-LINES attribute which defines the number of text lines
in the widget.
|
void |
setListItemPairs(character list)
Common implementation list item pair attributes (LIST-ITEM-PAIRS and
RADIO-BUTTONS) attribute.
|
void |
setMultiple(boolean multiple)
Set MULTIPLE attribute.
|
void |
setMultiple(logical multiple)
Set MULTIPLE attribute.
|
(package private) boolean |
setScreenValue(ScreenBuffer frameBuf,
java.lang.Object value,
boolean inUIStmt)
Internal worker for setting the SCREEN-VALUE on a per-widget basis.
|
void |
setScrollbarHorizontal(boolean horiz)
Set the value of the SCROLLBAR-HORIZONTAL attribute which controls whether the widget must
draw the horizontal scroll-bar if the inner width is more than the visible width.
|
void |
setScrollbarHorizontal(logical horiz)
Set the value of the SCROLLBAR-HORIZONTAL attribute which controls whether the widget must
draw the horizontal scroll-bar if the inner width is more than the visible width.
|
void |
setScrollbarVertical(boolean scrollbar)
Resets the vertical scroll-bar flag with the new one.
|
void |
setScrollbarVertical(logical scrollbar)
Resets the vertical scroll-bar flag with the new one.
|
void |
setSideLabelHandle(handle label)
Sets the text widget that is used as the side label for this widget.
|
void |
setSingle(boolean single)
Convenience method to turning off MULTIPLE attribute.
|
private boolean |
updateInnerLines(boolean chui,
int ilines)
Validates inner lines value and then updates configuration accordingly.
|
(package private) boolean |
validateScreenValue(character value)
Validate the value(s) for SCREEN-VALUE attribute, the delimiter is used
to split it into an array.
|
add, add, addFirst, addFirst, addFirst, addFirst, addFirst, addFirst, addFirst, addFirst, addFirst, addLast, addLast, addLast, addLast, addLast, addLast, checkIfNotPairs, checkValue, controlSetItem, delete, delete, delete, delete, delete, entry, entry, getDelimiter, getItemIndex, getListItemPairs, getListItems, getMousePointerImpl, ignore, ignore, insert, insert, insert, insert, insert, insert, insert, insert, insert, insert, insert, insert, insert, insert, insert, insert, insert, insert, insert, insert, insert, insert, insert, insert, invalid, isExpandLabel, isSort, isValidScreenValue, itemIndex, lookup, lookup, pairs, replace, replace, replace, replace, replace, replace, replace, replace, replace, replace, replace, replace, replace, replace, replace, replace, replace, replace, replace, replace, replace, replace, replace, replace, replace, replace, replace, replace, resolveFormat, setDelimiter, setDelimiter, setHonorFormat, setItems, setItems, setListItemPairs, setListItemPairsWorker, setListItems, setListItems, setMousePointerName, setSort, setSort, truncateValue, truncateValue, truncateValues, useListItemPairs, useListItems
changeFontWorker, delete, firstChild, getColon, getDataClass, getDataType, getIndex, getNextTabItem, getPreviousTabItem, getPrevSibling, getSideLabelHandleWorker, getTitle, hasSideLabelHandle, isAutoResize, isDropTarget, isModified, lastChild, processSideLabel, resetAutoResize, setAttrSpace, setAutoResize, setAutoResize, setColumnLabel, setColumnLabel, setDropTarget, setForceLabel, setForceLabel, setHeightCharsWorker, setHeightPixelsWorker, setIndex, setIndex, setModified, setModified, setNoAttrSpace, setNoLabels, setSideLabelHandleWorker, setTitle, setTitle, setTo, setTo, setWidthCharsWorker, setWidthPixelsWorker, validateFields
_getHeightChars, _getHeightPixels, _getWidthChars, _getWidthPixels, canSetPixelPositionInChui, emit4084Warning, emitUnableToAssignUnknownAttributeWarning, getBgColor, getBgColorRgb, getColumn, getDColor, getFgColor, getFgColorRgb, getFont, getFontInfo, getFontName, getFontSize, getFrameColumn, getFrameRow, getFrameX, getFrameY, getHeightPixels, getNextSibling, getParent, getParent, getPfColor, getRow, getTooltip, getValidParentTypes, getWidthPixels, getX, getY, isFontBold, isFontItalic, isFontUnderline, isMovable, isResizable, isSelected, isTabStop, prepareSizeChars, prepareSizePixels, pushLocAttrs, pushSizeAttrs, setAlign, setBgColor, setBgColor, setBgColor, setBgColorRgb, setBgColorRgb, setColon, setColon, setColumn, setColumn, setColumnOrRow, setColumnOrRowWorker, setDColor, setDColor, setDColor, setFgColor, setFgColor, setFgColor, setFgColorRgb, setFgColorRgb, setFont, setFontBold, setFontItalic, setFontName, setFontSize, setFontUnderline, setGroup, setHeightChars, setHeightChars, setHeightImpl, setHeightPixels, setHeightPixels, setMaxHeightCharsWorker, setMaxHeightPixelsWorker, setMaxWidthCharsWorker, setMaxWidthPixelsWorker, setMinHeightCharsWorker, setMinHeightPixelsWorker, setMinWidthCharsWorker, setMinWidthPixelsWorker, setMovable, setMovable, setParent, setPfColor, setPfColor, setPfColor, setResizable, setResizable, setRow, setRow, setSelected, setSelected, setSizeChars, setSizePixels, setSystemParent, setTabStop, setTabStop, setTooltip, setTooltip, setVirtHeightCharsWorker, setVirtHeightPixelsWorker, setVirtWidthCharsWorker, setVirtWidthPixelsWorker, setWidthChars, setWidthChars, setWidthImpl, setWidthPixels, setWidthPixels, setX, setX, setXorY, setXOrYWorker, setY, setY, useHandleChainSiblings, validateParent, validateSize, validColumnOrRow
_dynamic, _getDbName, _getFormat, _getTable, _isEntered, _isHidden, _isNotEntered, _isRealized, _isVisible, _setDynamic, _setVisible, afterConfigUpdate, apply, apply, apply, apply, asWidgetHandle, canAccess, canDelete, canPushWidgetAttr, cleanup, colorDisplay, colorPrompt, config, deselectRows, detachMenu, disable, dynamic, editUndo, enable, finishConfigProcessing, finishSetup, flushWidgetAttrs, genAssignUnknownWarning, getAttr, getAttr, getAttr, getAttr, getAttr, getAttr, getAttr, getAttr, getAttr, getAttr, getAttr, getAttr, getColumnFont, getColumnLabel, getContextHelpId, getConvert3D, getCursorOffset, getDbName, getFrame, getFrameHandle, getFrameName, getHeight, getHelp, getHWND, getId, getImage, getLabel, getLabelFont, getLabelStr, getLogicalTerminal, getMaxHeightChars, getMaxWidthChars, getMenuKey, getMenuMouse, getMousePointer, getMousePosition, getNumColumns, getNumSelectedRows, getParentHandle, getPopupMenu, getQuery, getRetainShape, getStretchToFit, getTable, getTabPosition, getTitleFont, getTransparent, getValidationExpression, getValidationMessage, getVirtHeight, getVirtHeightPixels, getVirtWidth, getVirtWidthPixels, getWidgetId, getWidth, getWindow, getZOrderClass, hasNameReadOnly, hasParent, hide, hide, implicitDeletion, inputValue, isAutoCompletion, isAutoReturn, isChained, isChecked, isDisableRedraw, isEntered, isFocusedRowSelected, isHidden, isKeepFrameZOrder, isManualHighlight, isNotEntered, isScrollable, isSelectable, isSensitive, isTabWidget, isTextSelected, isThreeD, isValidatable, isVisible, labelSizeCheck, loadImage, loadImage, loadImage, loadImage, loadImage, loadImage, loadImage, loadImage, loadImage, loadImage, loadMousePointer, loadMousePointer, moveAfterTab, moveAfterTab, moveBeforeTabItem, moveBeforeTabItem, moveToBottom, moveToTop, moveToWorker, name, notQueryable, notQueryable, notSettable, notSettable, notWorker, openPopup, preRealizeCheck, pushScreenDefinition, pushWidgetAttr, pushWidgetAttr, readOnlyError, readOnlyError, realize, refresh, resourceDelete, restoreSharedState, saveSharedState, selectAll, selectFocusedRow, setAtFormatLength, setAttr, setAttr, setAttr, setAttr, setAttr, setAttr, setAttr, setAttr, setAttr, setAttrs, setAutoCompletion, setAutoCompletion, setAutoReturn, setAutoReturn, setBlank, setChecked, setChecked, setColumnFont, setColumnFont, setContextHelpId, setContextHelpId, setConvert3D, setConvert3D, setCursorOffset, setCursorOffset, setDbname, setDeblank, setDisableAutoZap, setDisableRedraw, setFont, setFormat, setFrame, setFrame, setFrameHandle, setFrameHandle, setFrameHandle, setHeader, setHeight, setHelp, setHelp, setHelpDefault, setHelpStatic, setHidden, setHidden, setId, setKeepFrameZOrder, setKeepFrameZOrder, setLabel, setLabel, setLabel, setLabelFont, setLabelFont, setLabelInt, setManualHighlight, setManualHighlight, setMaxHeightChars, setMaxWidthChars, setMenuKey, setMenuKey, setMenuMouse, setMenuMouse, setNextTabItem, setNoAutoValidate, setNumSelectedRows, setParentHandle, setParentHandle, setPopupMenu, setPopupMenu, setQuery, setReadOnly, setReadOnly, setRetainShape, setRetainShape, setScreenLock, setScreenValue, setScreenValue, setScreenValueInt, setScreenValueNoErrorHandling, setScrollable, setScrollable, setSelectable, setSelectable, setSensitive, setSensitive, setSensitive, setSensitive, setStretchToFit, setStretchToFit, setTable, setThreeD, setThreeD, setTitleFont, setTitleFont, setTransparent, setTransparent, setValidation, setValidation, setVertical, setVirtHeight, setVirtHeightPixels, setVirtWidth, setVirtWidthPixels, setVisible, setVisible, setWidgetId, setWidgetId, setWidth, truncatePixelSize, underline, underline, valid, validate, validateFields, validateFields, validateFields, validateLabelAssignment, view, warningAlreadyRealized, widgetName
firstResource, firstResource, getHead, getNextSibling, getPrevSibling, getPrivateData, getTail, hasName, hasNameConstraints, hasNextSibling, hasPrevSibling, hasPrivateData, interlink, lastResource, lastResource, moveInChain, name, name, setHead, setNextSibling, setNextSibling, setPrevSibling, setPrevSibling, setPrivateData, setPrivateData, setPrivateData, validateName
doDelete, getResourceType, id, id, incrementTrigger, instantiatingProcedure, invalidAttribute, processResource, registerResource, setInstantiatingProcedure, toString, type, unableToAssignUnknown, unknown
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
isSort, setSort, setSort
apply, apply, apply, apply, asWidgetHandle, colorDisplay, colorPrompt, deselectRows, disable, editUndo, enable, getBgColor, getBgColorRgb, getColumnFont, getContextHelpId, getCursorOffset, getDColor, getFgColor, getFgColorRgb, getFont, getFrame, getFrameColumn, getFrameHandle, getFrameName, getFrameRow, getFrameX, getFrameY, getHWND, getId, getIdEx, getImage, getLabelFont, getLabelStr, getMaxHeightChars, getMaxWidthChars, getMenuKey, getMenuMouse, getMousePointer, getMousePosition, getNextTabItem, getNumColumns, getNumSelectedRows, getParent, getParentHandle, getPfColor, getPopupMenu, getPreviousTabItem, getQuery, getTabPosition, getTitle, getTitleFont, getTooltip, getVirtHeight, getVirtHeightPixels, getVirtWidth, getVirtWidthPixels, getWidgetId, getWindow, hide, hide, inputValue, isAutoCompletion, isAutoResize, isEditCanUndo, isEntered, isFocusedRowSelected, isHidden, isKeepFrameZOrder, isManualHighlight, isModified, isMovable, isNotEntered, isResizable, isScrollable, isSelectable, isSelected, isTabStop, isThreeD, isValidatable, loadMousePointer, loadMousePointer, moveAfterTab, moveAfterTab, moveBeforeTabItem, moveBeforeTabItem, moveToBottom, moveToTop, openPopup, preRealizeCheck, realize, refresh, selectAll, selectFocusedRow, setAtFormatLength, setAutoCompletion, setAutoCompletion, setAutoResize, setAutoResize, setBgColor, setBgColorRgb, setBlank, setColumnFont, setColumnFont, setContextHelpId, setContextHelpId, setCursorOffset, setCursorOffset, setDColor, setDColor, setDeblank, setDisableAutoZap, setFgColor, setFgColorRgb, setFont, setFont, setFrame, setFrame, setFrameHandle, setFrameHandle, setFrameHandle, setGroup, setHeader, setHidden, setHidden, setId, setKeepFrameZOrder, setKeepFrameZOrder, setLabelFont, setLabelFont, setManualHighlight, setManualHighlight, setMaxHeightChars, setMaxWidthChars, setMenuKey, setMenuKey, setMenuMouse, setMenuMouse, setModified, setModified, setMovable, setMovable, setNextTabItem, setNumSelectedRows, setParent, setParentHandle, setParentHandle, setPfColor, setPfColor, setPopupMenu, setPopupMenu, setQuery, setReadOnly, setReadOnly, setResizable, setResizable, setScreenValue, setScreenValue, setScrollable, setScrollable, setSelectable, setSelectable, setSelected, setSelected, setSensitive, setTabStop, setTabStop, setThreeD, setThreeD, setTitle, setTitle, setTitleFont, setTitleFont, setTooltip, setTooltip, setValidation, setValidation, setVertical, setVirtHeight, setVirtHeightPixels, setVirtWidth, setVirtWidthPixels, setWidgetId, setWidgetId, underline, underline, valid, validateFields, validateFields, validateFields, view
getNextSibling, getPrevSibling, getPrivateData, setPrivateData, setPrivateData
getResourceType, readOnlyError, readOnlyError
id, id, unknown
getColumnLabel, getDataType, getHelp, getLabel, setColumnLabel, setColumnLabel, setFormat, setHelp, setHelp, setLabel, setLabel, setLabel
getDbName, getTable
isDisableRedraw, setDisableRedraw, setDisableRedraw
isVisible, setVisible, setVisible
getHeight, getHeightPixels, getWidth, getWidthPixels, setHeight, setHeightChars, setHeightChars, setHeightPixels, setHeightPixels, setWidth, setWidthChars, setWidthChars, setWidthPixels, setWidthPixels
getColumn, getRow, getX, getY, setColumn, setColumn, setRow, setRow, setX, setX, setY, setY
getRetainShape, getStretchToFit, getTransparent, setRetainShape, setRetainShape, setStretchToFit, setStretchToFit, setTransparent, setTransparent
getConvert3D, loadImage, loadImage, loadImage, loadImage, loadImage, loadImage, loadImage, loadImage, loadImage, loadImage, setConvert3D, setConvert3D
replace, replace, replace, replace, replace, replace, replace, replace
endFileDrop, getDroppedFile, getDroppedFile, getNumDroppedFiles, setDropTarget
public SelectionListWidget()
public SelectionListWidget(boolean dynamic)
dynamic
- Flag indicating if this is a static or dynamic resource.public integer getInnerChars()
getInnerChars
in interface ScrollbarHorizontalElement
public void setInnerChars(double chars)
setInnerChars
in interface ScrollbarHorizontalElement
chars
- The new value for the attribute.public void setInnerChars(NumberType chars)
setInnerChars
in interface ScrollbarHorizontalElement
chars
- The new value for the attribute.public integer getInnerLines()
getInnerLines
in interface InnerLines
public void setInitialInnerLines(double lines)
setInitialInnerLines
in interface InnerLines
lines
- The new number of lines.public void setInnerLines(double lines)
setInnerLines
in interface InnerLines
lines
- The new number of lines.public void setInnerLines(NumberType lines)
setInnerLines
in interface InnerLines
lines
- The new number of lines.public decimal getHeightChars()
getHeightChars
in interface Sizeable
getHeightChars
in class BaseEntity<SelectionListConfig>
public decimal getWidthChars()
getWidthChars
in interface Sizeable
getWidthChars
in class BaseEntity<SelectionListConfig>
public logical isMultiple()
isMultiple
in interface CommonWidget
isMultiple
in interface Multiple
isMultiple
in class GenericWidget<SelectionListConfig>
public void setMultiple(boolean multiple)
setMultiple
in interface CommonWidget
setMultiple
in interface Multiple
setMultiple
in class GenericWidget<SelectionListConfig>
multiple
- New value for the attribute.public void setMultiple(logical multiple)
setMultiple
in interface CommonWidget
setMultiple
in interface Multiple
setMultiple
in class GenericWidget<SelectionListConfig>
multiple
- New value for the attribute.public void setSingle(boolean single)
single
- New value for the attribute.public integer getNumItems()
getNumItems
in interface NumItems
public logical isScrollbarHorizontal()
isScrollbarHorizontal
in interface ScrollbarHorizontalElement
public void setScrollbarHorizontal(logical horiz)
setScrollbarHorizontal
in interface ScrollbarHorizontalElement
horiz
- The new value for the attribute.public void setScrollbarHorizontal(boolean horiz)
setScrollbarHorizontal
in interface ScrollbarHorizontalElement
horiz
- The new value for the attribute.public logical isScrollbarVertical()
isScrollbarVertical
in interface ScrollbarVerticalElement
public void setScrollbarVertical(logical scrollbar)
setScrollbarVertical
in interface ScrollbarVerticalElement
scrollbar
- New value for the SCROLLBAR-VERTICAL attribute.public void setScrollbarVertical(boolean scrollbar)
setScrollbarVertical
in interface ScrollbarVerticalElement
scrollbar
- New value for the SCROLLBAR-VERTICAL attribute.public logical isSelected(character item)
isSelected
in interface CommonWidget
isSelected
in class GenericWidget<SelectionListConfig>
item
- a string representation of an item to checkpublic logical isSelected(int64 index)
isSelected
in interface CommonWidget
isSelected
in class GenericWidget<SelectionListConfig>
index
- 1-based index of an item to checkprivate boolean isSelected(int index)
index
- 1-based index of an item to checktrue
if the specified item is selectedpublic character getScreenValue()
character
type. If
there is no value in the screen buffer (if it is null
which is the representation for an uninitialized value), then return
the empty string.getScreenValue
in interface CommonWidget
getScreenValue
in class GenericWidget<SelectionListConfig>
character
type or the empty
string if the screen buffer value is uninitialized.public logical delete(character itemList)
delete
in interface CommonListWidget<SelectionListConfig>
itemList
- The item or items to delete.true
if the method succeeds.public logical delete(java.lang.String itemList)
delete
in interface CommonListWidget<SelectionListConfig>
itemList
- The item or items to delete.true
if the method succeeds.public void setFrame(FrameWidget frame)
setFrame
in interface CommonWidget
setFrame
in class GenericWidget<SelectionListConfig>
frame
- GenericFrame
instance that contains this widgetpublic logical scrollToItem(int index)
scrollToItem
in interface SelectionListInterface
index
- The 1-based index of an item to scroll.TRUE
in success, FALSE
otherwise.public logical scrollToItem(NumberType index)
scrollToItem
in interface SelectionListInterface
index
- The 1-based index of an item to scroll.TRUE
in success, FALSE
otherwise.public logical scrollToItem(character name)
scrollToItem
in interface SelectionListInterface
name
- The name of an item to scroll.TRUE
in success, FALSE
otherwise.public logical scrollToItem(java.lang.String name)
scrollToItem
in interface SelectionListInterface
name
- The name of an item to scroll.TRUE
in success, FALSE
otherwise.public void setListItemPairs(character list)
Example: Label1,value1,Label2,value2,...,LabelN,valueN
setListItemPairs
in interface CommonListWidget<SelectionListConfig>
setListItemPairs
in class ControlSetEntity<SelectionListConfig>
list
- A list of delimited items using the configured delimiter for
this widget (a comma by default) to split the items. These
items will be set as the full list of items in this widget.public void setDataType(character dataType)
setDataType
in interface CommonField
setDataType
in class ControlEntity<SelectionListConfig>
dataType
- new value of DATA-TYPE attributepublic void setDataType(java.lang.String dataType)
setDataType
in interface CommonField
setDataType
in class ControlEntity<SelectionListConfig>
dataType
- new value of DATA-TYPE attributepublic void setFormat(java.lang.String format)
setFormat
in interface CommonWidget
setFormat
in interface CommonField
setFormat
in class GenericWidget<SelectionListConfig>
format
- The format specification.public character getFormat()
getFormat
in interface CommonField
getFormat
in class GenericWidget<SelectionListConfig>
public boolean hasFormat()
hasFormat
in class GenericWidget<SelectionListConfig>
FALSE
.public void setSideLabelHandle(handle label)
setSideLabelHandle
in interface CommonWidget
setSideLabelHandle
in class GenericWidget<SelectionListConfig>
label
- The handle to the text widget to be used as the side label of this widget.public handle getSideLabelHandle()
getSideLabelHandle
in interface CommonWidget
getSideLabelHandle
in class GenericWidget<SelectionListConfig>
character getScreenValue(boolean initialized, BaseDataType bdt, java.lang.String fmt, boolean ignoreFormat)
getScreenValue
in class GenericWidget<SelectionListConfig>
initialized
- Flag indicating if the widget is realized or not.bdt
- The current value in the frame's buffer.fmt
- The format to be applied, in case this is a formatted value.ignoreFormat
- Flag indicating if the format needs to be ignored.boolean setScreenValue(ScreenBuffer frameBuf, java.lang.Object value, boolean inUIStmt)
setScreenValue
in class ControlSetEntity<SelectionListConfig>
frameBuf
- The frame buffer where to save the value.value
- The value to be set via SCREEN-VALUE attribute.inUIStmt
- Flag indicating this call originates from a UI statement.true
if the caller can proceed, as the screen-value can be set.boolean validateScreenValue(character value)
validateScreenValue
in class ControlSetEntity<SelectionListConfig>
value
- The to be validated as SCREEN-VALUE attribute.true
if the value is a valid screen-value.protected boolean isValidScreenValue(character value)
isValidScreenValue
in class ControlSetEntity<SelectionListConfig>
value
- The tested valueprivate boolean scrollToItemInt(int index)
index
- The 1-based index of an item to scroll.TRUE
in success, FALSE
otherwise.private boolean updateInnerLines(boolean chui, int ilines)
chui
- True value indicates that the client type is CHUI, otherwise it is GUI.ilines
- New value of inner linesprotected void getSizeAttrs(java.util.List<java.lang.String> names, java.util.List<java.lang.Object> vals)
getSizeAttrs
in class ControlEntity<SelectionListConfig>
names
- The collection where to add the field names.vals
- The collection where to add the field values.