public class MultiComboBoxItem extends CanvasItem
layoutStyle attribute. The
buttons will be kept in the order that they were added, with the most recently added button being adjacent to the combo
box. MultiComboBoxItem uses the com.smartgwt.client.types.AutoChild pattern to construct the comboBox and the buttons so that they can be easily customized. For
example, you can customize the criteria used to fetch by using ComboBoxItem.setPickListFilterCriteriaFunction() with setComboBoxProperties().ComboBoxItemFormItem.CustomStateGetter, FormItem.StateCustomizerconfigOnly, scClassName, warnOnEditorTypeConversion, warnOnEditorTypeConversionDefaultidfactoryCreated, factoryProperties| Constructor and Description |
|---|
MultiComboBoxItem() |
MultiComboBoxItem(com.google.gwt.core.client.JavaScriptObject jsObj) |
MultiComboBoxItem(java.lang.String name) |
MultiComboBoxItem(java.lang.String name,
java.lang.String title) |
| Modifier and Type | Method and Description |
|---|---|
static void |
changeAutoChildDefaults(java.lang.String autoChildName,
Canvas defaults)
Changes the defaults for Canvas AutoChildren named
autoChildName. |
static void |
changeAutoChildDefaults(java.lang.String autoChildName,
FormItem defaults)
Changes the defaults for FormItem AutoChildren named
autoChildName. |
static void |
changePickerIconDefaults(FormItemIcon defaults) |
java.lang.Boolean |
getAddUnknownValues()
Similar to
ComboBoxItem.addUnknownValues, controls whether additional values can be added to the ComboBox or whether the user must
choose from the available values in the picklist only. |
java.lang.Boolean |
getAlwaysExitOnTab()
If true, hitting tab always exits the field, and will also add a value to the list of selected values if there is match
(and depending on the setting for
addUnknownValues). |
java.lang.Boolean |
getAutoFetchData()
Should the MultiComboBoxItem fetch data from the
data source immediately or wait until the
user first opens the pickList. |
java.lang.Boolean |
getAutoFitButtons()
Specifies whether to autofit the buttons in the MultiComboBoxItem.
|
java.lang.String |
getAutoOpenTree()
When this item is showing a tree-based picker, which nodes should be opened automatically.
|
IButton |
getButton()
Note : This API is non-functional (always returns null) and exists only to make
you aware that this MultiAutoChild exists.
|
IButton |
getButtonDefaults()
Default properties to be used in creating each
IButton. |
IButton |
getButtonProperties()
Properties to be used in creating each option button.
|
ComboBoxItem |
getComboBox()
An
com.smartgwt.client.types.AutoChild attribute to create the combo box in a MultiComboBoxItem. |
ComboBoxItem |
getComboBoxDefaults()
Default properties for the
ComboBoxItem in a MultiComboBoxItem. |
ComboBoxItem |
getComboBoxProperties()
Properties to be used in creating a
ComboBoxItem. |
int |
getComboBoxWidth()
Specifies the size of the combo box field.
|
DynamicForm |
getComboForm()
The
DynamicForm holding the comboBox. |
java.lang.String |
getDataSetType()
Whether to show the picker as a flat list, or a collapsible tree.
|
java.lang.String |
getDeselectedButtonStyle()
When
showDeletions is true, the
Button.baseStyle used on buttons for values that have been deleted (also
called "deselected buttons"). |
java.lang.String |
getDisplayField()
The
displayField of the combo box. |
MultiComboBoxLayoutStyle |
getLayoutStyle()
Specifies the layout style of the combo box and the buttons in the MultiComboBoxItem.
|
DataSource |
getOptionDataSource()
The
optionDataSource of the combo box. |
java.lang.String |
getOptionOperationId()
If this item has a specified
optionDataSource, this attribute may be set to specify an explicit DSRequest.operationId when performing a fetch against the option
dataSource to pick up display value mapping. |
static MultiComboBoxItem |
getOrCreateRef(com.google.gwt.core.client.JavaScriptObject jsObj) |
java.lang.String |
getPendingButtonStyle()
When
showPending is true, the
Button.baseStyle used on buttons that are in the "Pending" visual state. |
java.lang.String |
getPickListConstructor()
The Class to use when creating a picker of type "list" for a FormItem.
|
java.lang.String |
getPickTreeConstructor()
The Class to use when creating a picker of type "tree" for a FormItem.
|
java.lang.String |
getRootNodeId()
|
java.lang.Integer |
getRootNodeIdAsInt()
|
java.lang.Boolean |
getShouldSaveValue()
Should this item's value be saved in the form's values and hence returned from
form.getValues()? |
java.lang.Boolean |
getUseInsertionOrder()
Specifies whether to arrange the buttons of the MultiComboBoxItem in the order that they were selected (the default), or
to sort the buttons by
displayField. |
java.lang.String |
getValueField()
The
valueField of the combo box. |
Layout |
getValueLayout()
Note : This API is non-functional (always returns null) and exists only to make
you aware that this MultiAutoChild exists.
|
java.lang.String[] |
getValues() |
boolean |
pendingStatusChanged(DynamicForm form,
FormItem item,
boolean pendingStatus,
java.lang.Object newValue,
java.lang.Object value)
Notification method called when
showPending is
enabled and this MultiComboBoxItem should either clear or show its pending visual state. |
MultiComboBoxItem |
setAddUnknownValues(java.lang.Boolean addUnknownValues)
Similar to
ComboBoxItem.addUnknownValues, controls whether additional values can be added to the ComboBox or whether the user must
choose from the available values in the picklist only. |
MultiComboBoxItem |
setAlwaysExitOnTab(java.lang.Boolean alwaysExitOnTab)
If true, hitting tab always exits the field, and will also add a value to the list of selected values if there is match
(and depending on the setting for
addUnknownValues). |
MultiComboBoxItem |
setAutoFetchData(java.lang.Boolean autoFetchData)
Should the MultiComboBoxItem fetch data from the
data source immediately or wait until the
user first opens the pickList. |
MultiComboBoxItem |
setAutoFitButtons(java.lang.Boolean autoFitButtons)
Specifies whether to autofit the buttons in the MultiComboBoxItem.
|
MultiComboBoxItem |
setAutoOpenTree(java.lang.String autoOpenTree)
When this item is showing a tree-based picker, which nodes should be opened automatically.
|
void |
setButtonProperties(IButton buttonProperties)
Properties to be used in creating each option button.
|
void |
setComboBoxProperties(ComboBoxItem comboBoxProperties)
Properties to be used in creating a
ComboBoxItem. |
MultiComboBoxItem |
setComboBoxWidth(int comboBoxWidth)
Specifies the size of the combo box field.
|
MultiComboBoxItem |
setDataSetType(java.lang.String dataSetType)
Whether to show the picker as a flat list, or a collapsible tree.
|
static void |
setDefaultProperties(MultiComboBoxItem multiComboBoxItemProperties)
Class level method to set the default properties of this class.
|
MultiComboBoxItem |
setDeselectedButtonStyle(java.lang.String deselectedButtonStyle)
When
showDeletions is true, the
Button.baseStyle used on buttons for values that have been deleted (also
called "deselected buttons"). |
MultiComboBoxItem |
setDisplayField(java.lang.String displayField)
The
displayField of the combo box. |
MultiComboBoxItem |
setLayoutStyle(MultiComboBoxLayoutStyle layoutStyle)
Specifies the layout style of the combo box and the buttons in the MultiComboBoxItem.
|
MultiComboBoxItem |
setOptionDataSource(DataSource optionDataSource)
The
optionDataSource of the combo box. |
MultiComboBoxItem |
setOptionOperationId(java.lang.String optionOperationId)
If this item has a specified
optionDataSource, this attribute may be set to specify an explicit DSRequest.operationId when performing a fetch against the option
dataSource to pick up display value mapping. |
MultiComboBoxItem |
setPendingButtonStyle(java.lang.String pendingButtonStyle)
When
showPending is true, the
Button.baseStyle used on buttons that are in the "Pending" visual state. |
MultiComboBoxItem |
setPickListConstructor(java.lang.String pickListConstructor)
The Class to use when creating a picker of type "list" for a FormItem.
|
MultiComboBoxItem |
setPickTreeConstructor(java.lang.String pickTreeConstructor)
The Class to use when creating a picker of type "tree" for a FormItem.
|
MultiComboBoxItem |
setRootNodeId(java.lang.Integer rootNodeId)
|
MultiComboBoxItem |
setRootNodeId(java.lang.String rootNodeId)
|
MultiComboBoxItem |
setShouldSaveValue(java.lang.Boolean shouldSaveValue)
Should this item's value be saved in the form's values and hence returned from
form.getValues()? |
MultiComboBoxItem |
setUseInsertionOrder(java.lang.Boolean useInsertionOrder)
Specifies whether to arrange the buttons of the MultiComboBoxItem in the order that they were selected (the default), or
to sort the buttons by
displayField. |
MultiComboBoxItem |
setValueField(java.lang.String valueField)
The
valueField of the combo box. |
void |
setValues(java.lang.Object... values) |
void |
showValue(java.lang.Object displayValue,
java.lang.Object dataValue,
DynamicForm form,
CanvasItem item)
This method will be called whenever this FormItem's value is being set via a programmatic call to e.g:
DynamicForm.setValues() or FormItem.setValue() and may be overridden by CanvasItems
intended to support displaying data values to update the embedded Canvas to reflect the value passed in. |
addCanEditChangedHandler, addReadOnlyDisplayChangedHandler, addShowValueHandler, createCanvas, getApplyPromptToCanvas, getAutoDestroy, getCanvas, getEditCriteriaInInnerForm, getHeight, getHeightAsString, getMaxHeight, getMinHeight, getMultiple, getOverflow, getPrompt, hasAdvancedCriteria, isFocused, setApplyPromptToCanvas, setAutoDestroy, setCanEditCriterionPredicate, setCanvas, setCriterionGetter, setCriterionSetter, setDefaultProperties, setEditCriteriaInInnerForm, setHeight, setHeight, setMaxHeight, setMinHeight, setMultiple, setOverflow, setPrompt, setShouldDisableCanvasCustomizer, setupCanvasConstructor, storeValue, storeValue, storeValue, updateCanvasTabPosition_getValue, addBlurHandler, addChangedHandler, addChangeHandler, addClickHandler, addDoubleClickHandler, addEditorEnterHandler, addEditorExitHandler, addFocusHandler, addIcon, addIcon, addIconClickHandler, addIconKeyPressHandler, addItemHoverHandler, addKeyDownHandler, addKeyPressHandler, addKeyUpHandler, addPendingStatusChangedHandler, addPickerIconClickHandler, addShowContextMenuHandler, addTitleClickHandler, addTitleDoubleClickHandler, addTitleHoverHandler, addValueHoverHandler, addValueIconClickHandler, applyFormula, asSGWTComponent, blurItem, canEditCriterion, clearErrors, clearValue, disable, disableIcon, enable, enableIcon, error, error, errorIfNotCreated, focusAfterItem, focusInItem, getAccessKey, getAlign, getAllowExpressions, getAlwaysFetchMissingValues, getAlwaysShowControlBox, getApplyAlignToText, getApplyHeightToTextBox, getAriaRole, getAttribute, getAttributeAsBoolean, getAttributeAsBoolean, getAttributeAsDate, getAttributeAsDouble, getAttributeAsFloat, getAttributeAsInt, getAttributeAsJavaScriptObject, getAttributeAsObject, getAttributeAsString, getAutoComplete, getAutoCompleteKeywords, getBrowserInputType, getBrowserSpellCheck, getCanEdit, getCanEditOpaqueValues, getCanFocus, getCanSelectText, getCanTabToIcons, getCanvasAutoChild, getCellHeight, getCellStyle, getChangeOnKeypress, getClassName, getClipStaticValue, getClipTitle, getConfig, getContainerWidget, getControlStyle, getCriteriaField, getCriterion, getCriterion, getCursorPosition, getCustomState, getDataPath, getDateFormatter, getDecimalPad, getDecimalPrecision, getDefaultIconSrc, getDefaultOperator, getDestroyed, getDisabled, getDisabledHover, getDisableIconsOnReadOnly, getDisplayFieldName, getDisplayValue, getDisplayValue, getEditorTypeConfig, getEditPendingCSSText, getEditProxyConstructor, getEmptyDisplayValue, getEmptyValueIcon, getEndRow, getErrorIconHeight, getErrorIconSrc, getErrorIconWidth, getErrorMessageWidth, getErrors, getEscapeHTML, getExportFormat, getFetchMissingValues, getFieldName, getFilterLocally, getForeignDisplayField, getForm, getFormat, getFormItemAutoChild, getFormula, getFullDataPath, getGlobalTabIndex, getGridColNum, getGridRowNum, getHidden, getHint, getHintStyle, getHoverAlign, getHoverDelay, getHoverHeight, getHoverHeightAsString, getHoverOpacity, getHoverStyle, getHoverVAlign, getHoverWidth, getHoverWidthAsString, getIcon, getIconHeight, getIconHSpace, getIconPageRect, getIconPrompt, getIconRect, getIcons, getIconTabPosition, getIconVAlign, getIconWidth, getID, getImageURLPrefix, getImageURLSuffix, getImplicitSave, getImplicitSaveOnBlur, getInputFormat, getLeft, getListGrid, getLoadingDisplayValue, getLocateItemBy, getMinHintWidth, getMultipleValueSeparator, getName, getNullOriginalValueText, getOperator, getOptionCriteria, getOptionDataSourceAsString, getOptionFilterContext, getOptionTextMatchStyle, getOriginalValueMessage, getPageLeft, getPageRect, getPageTop, getPaletteDefaults, getPicker, getPickerIcon, getPickerIcon, getPickerIconHeight, getPickerIconName, getPickerIconPrompt, getPickerIconProperties, getPickerIconSrc, getPickerIconStyle, getPickerIconTabPosition, getPickerIconWidth, getPixelHeight, getPixelWidth, getPrintReadOnlyTextBoxStyle, getPrintTextBoxStyle, getPrintTitleStyle, getReadOnlyCanSelectText, getReadOnlyDisplay, getReadOnlyHover, getReadOnlyTextBoxStyle, getReadOnlyWhen, getRect, getRedrawOnChange, getRejectInvalidValueOnChange, getRequired, getRequiredMessage, getRequiredWhen, getRowSpan, getSaveOnEnter, getScClassName, getSelectedRecord, getSelectOnClick, getSelectOnFocus, getShowClippedTitleOnHover, getShowClippedValueOnHover, getShowDeletions, getShowDisabled, getShowDisabledIconsOnFocus, getShowDisabledPickerIconOnFocus, getShowErrorIcon, getShowErrorStyle, getShowErrorText, getShowFocused, getShowFocusedErrorState, getShowFocusedIcons, getShowFocusedPickerIcon, getShowHint, getShowIcons, getShowIconsOnFocus, getShowImageAsURL, getShowOldValueInHover, getShowOver, getShowOverIcons, getShowPending, getShowPickerIcon, getShowPickerIconOnFocus, getShowRTL, getShowTitle, getShowValueIconOnly, getStartRow, getStaticHeight, getStopOnError, getStoreDisplayValues, getSupportsCutPasteEvents, getSuppressValueIcon, getSynchronousValidation, getTabIndex, getTextAlign, getTextBoxStyle, getTextFormula, getTimeFormatter, getTitle, getTitleAlign, getTitleColSpan, getTitleOrientation, getTitleStyle, getTitleVAlign, getTooltip, getTop, getType, getUpdateControlOnOver, getUpdatePickerIconOnOver, getUpdateTextBoxOnOver, getUseAdvancedCriteria, getUseDisabledHintStyleForReadOnly, getUseLocalDisplayFieldValue, getValidateOnChange, getValidateOnExit, getValidOperators, getVAlign, getValue, getValueAsInteger, getValueAsLong, getValueAsRecordList, getValueDeselectedCSSText, getValueFieldName, getValueIconHeight, getValueIconLeftPadding, getValueIconRightPadding, getValueIconSize, getValueIconWidth, getValueMap, getValueMapAsArray, getVisible, getVisibleHeight, getVisibleTitleWidth, getVisibleWhen, getVisibleWidth, getWarnOnEditorTypeConversion, getWarnOnEditorTypeConversionDefault, getWidth, getWidthAsString, getWrapHintText, getWrapTitle, handleWarnOnEditorTypeConversion, hasErrors, hide, hideIcon, invalidateDisplayValueCache, isConfigOnly, isCreated, isCutEvent, isDisabled, isDrawn, isInGrid, isPasteEvent, isVisible, linkToInstanceUponCreate, mapDisplayToValue, mapValueToDisplay, mapValueToDisplay, mapValueToDisplay, redraw, redraw, removeIcon, selectedRecordChanged, setAccessKey, setAlign, setAllowExpressions, setAlwaysFetchMissingValues, setAlwaysShowControlBox, setApplyAlignToText, setApplyHeightToTextBox, setAriaRole, setAriaState, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAutoChildConstructor, setAutoChildProperties, setAutoChildProperties, setAutoChildProperties, setAutoChildVisibility, setAutoComplete, setAutoCompleteKeywords, setBrowserInputType, setBrowserSpellCheck, setCanEdit, setCanEditOpaqueValues, setCanFocus, setCanSelectText, setCanTabToIcons, setCellHeight, setCellStyle, setChangeOnKeypress, setClipStaticValue, setClipTitle, setColSpan, setColSpan, setConfigOnly, setControlStyle, setCriteriaField, setCriterion, setCustomStateGetter, setDataPath, setDateFormatter, setDecimalPad, setDecimalPrecision, setDefaultIconSrc, setDefaultOperator, setDefaultProperties, setDefaultValue, setDefaultValue, setDefaultValue, setDefaultValue, setDefaultValue, setDefaultValue, setDefaultValue, setDisabled, setDisabledHover, setDisableIconsOnReadOnly, setDisplayFormat, setDisplayFormat, setEditorProperties, setEditorType, setEditorType, setEditorType, setEditorValueFormatter, setEditorValueParser, setEditPendingCSSText, setEditProxyConstructor, setEmptyDisplayValue, setEmptyValueIcon, setEndRow, setErrorFormatter, setErrorIconHeight, setErrorIconSrc, setErrorIconWidth, setErrorMessageWidth, setErrorOrientation, setErrors, setErrors, setEscapeHTML, setExportFormat, setFetchMissingValues, setFilterLocally, setForeignDisplayField, setFormat, setFormula, setGlobalTabIndex, setHidden, setHint, setHintStyle, setHoverAlign, setHoverDelay, setHoverHeight, setHoverHeight, setHoverOpacity, setHoverStyle, setHoverVAlign, setHoverWidth, setHoverWidth, setIconDisabled, setIconHeight, setIconHSpace, setIconPrompt, setIcons, setIconShowOnFocus, setIconVAlign, setIconWidth, setID, setImageURLPrefix, setImageURLSuffix, setImplicitSave, setImplicitSaveOnBlur, setInitHandler, setInputFormat, setInputTransformer, setItemHoverFormatter, setItemTitleHoverFormatter, setItemValueHoverFormatter, setJavaScriptObject, setLeft, setLoadingDisplayValue, setLocateItemBy, setMinHintWidth, setMultipleValueSeparator, setName, setNullOriginalValueText, setNullProperty, setOperator, setOptionCriteria, setOptionDataSource, setOptionFilterContext, setOptionTextMatchStyle, setOriginalValueMessage, setPickerIconHeight, setPickerIconName, setPickerIconPrompt, setPickerIconProperties, setPickerIconSrc, setPickerIconStyle, setPickerIconWidth, setPrintReadOnlyTextBoxStyle, setPrintTextBoxStyle, setPrintTitleStyle, setProperty, setProperty, setProperty, setProperty, setProperty, setReadOnlyCanSelectText, setReadOnlyDisplay, setReadOnlyHover, setReadOnlyTextBoxStyle, setReadOnlyWhen, setRedrawOnChange, setRejectInvalidValueOnChange, setRequired, setRequiredMessage, setRequiredWhen, setRowSpan, setSaveOnEnter, setScClassName, setSelectOnClick, setSelectOnFocus, setShowClippedTitleOnHover, setShowClippedValueOnHover, setShowDeletions, setShowDisabled, setShowDisabledIconsOnFocus, setShowDisabledPickerIconOnFocus, setShowErrorIcon, setShowErrorStyle, setShowErrorText, setShowFocused, setShowFocusedErrorState, setShowFocusedIcons, setShowFocusedPickerIcon, setShowHint, setShowIcons, setShowIconsOnFocus, setShowIfCondition, setShowImageAsURL, setShowOldValueInHover, setShowOver, setShowOverIcons, setShowPending, setShowPickerIcon, setShowPickerIconOnFocus, setShowRTL, setShowTitle, setShowValueIconOnly, setStartRow, setStateCustomizer, setStaticHeight, setStopOnError, setStoreDisplayValues, setSupportsCutPasteEvents, setSuppressValueIcon, setSynchronousValidation, setTabIndex, setTextAlign, setTextBoxStyle, setTextFormula, setTimeFormatter, setTitle, setTitleAlign, setTitleColSpan, setTitleHoverFormatter, setTitleOrientation, setTitleStyle, setTitleVAlign, setTooltip, setTop, setType, setUpdateControlOnOver, setUpdatePickerIconOnOver, setUpdateTextBoxOnOver, setUseAdvancedCriteria, setUseDisabledHintStyleForReadOnly, setUseLocalDisplayFieldValue, setValidateOnChange, setValidateOnExit, setValidators, setValidOperators, setVAlign, setValue, setValue, setValue, setValue, setValue, setValue, setValueDeselectedCSSText, setValueFormatter, setValueHoverFormatter, setValueIconHeight, setValueIconLeftPadding, setValueIconMapper, setValueIconRightPadding, setValueIcons, setValueIconSize, setValueIconWidth, setValueMap, setValueMap, setVisible, setVisibleWhen, setWarnOnEditorTypeConversion, setWarnOnEditorTypeConversionDefault, setWidth, setWidth, setWrapHintText, setWrapTitle, shouldApplyHeightToTextBox, shouldFetchMissingValue, shouldSaveOnEnter, shouldStopKeyPressBubbling, show, showIcon, showPicker, stopHover, storeValue, updateState, validate, valueClippedgetRef, getRef, internalSetIDapplyFactoryProperties, doAddHandler, fireEvent, getAttributeAsDoubleArray, getAttributeAsIntArray, getAttributeAsLong, getAttributeAsMap, getAttributeAsObject, getAttributeAsRecord, getAttributeAsStringArray, getAttributes, getHandlerCount, isFactoryCreated, setAttribute, setAttribute, setAttribute, setAttributeAsJavaObject, setFactoryCreatedpublic MultiComboBoxItem()
public MultiComboBoxItem(com.google.gwt.core.client.JavaScriptObject jsObj)
public MultiComboBoxItem(java.lang.String name)
public MultiComboBoxItem(java.lang.String name,
java.lang.String title)
public static MultiComboBoxItem getOrCreateRef(com.google.gwt.core.client.JavaScriptObject jsObj)
public static void changeAutoChildDefaults(java.lang.String autoChildName,
Canvas defaults)
autoChildName.autoChildName - name of an AutoChild to customize the defaults for.defaults - Canvas defaults to apply. These defaults override any existing properties
without destroying or wiping out non-overridden properties. For usage tips on this
param, see SGWTProperties.AutoChildUsagepublic static void changeAutoChildDefaults(java.lang.String autoChildName,
FormItem defaults)
autoChildName.autoChildName - name of an AutoChild to customize the defaults for.defaults - FormItem defaults to apply. These defaults override any existing properties
without destroying or wiping out non-overridden properties. For usage tips on this
param, see SGWTProperties.AutoChildUsagepublic static void changePickerIconDefaults(FormItemIcon defaults)
public MultiComboBoxItem setAddUnknownValues(java.lang.Boolean addUnknownValues)
ComboBoxItem.addUnknownValues, controls whether additional values can be added to the ComboBox or whether the user must
choose from the available values in the picklist only. If this setting is changed after the MultiComboBoxItem has
been created, the current value of the item is reset to null and all buttons for non-default values (values not in the
FormItem.defaultValue array) are removed.
addUnknownValues - New addUnknownValues value. Default value is falseMultiComboBoxItem instance, for chaining setter callspublic java.lang.Boolean getAddUnknownValues()
ComboBoxItem.addUnknownValues, controls whether additional values can be added to the ComboBox or whether the user must
choose from the available values in the picklist only. If this setting is changed after the MultiComboBoxItem has
been created, the current value of the item is reset to null and all buttons for non-default values (values not in the
FormItem.defaultValue array) are removed.
public MultiComboBoxItem setAlwaysExitOnTab(java.lang.Boolean alwaysExitOnTab)
addUnknownValues). If false, if the user has typed in a value and hits tab, focus remains in the field. If there is
a match or if addUnknownValues is
true, a value will be added. Otherwise, the input cursor remains at the end of the entered value.
alwaysExitOnTab - New alwaysExitOnTab value. Default value is trueMultiComboBoxItem instance, for chaining setter callspublic java.lang.Boolean getAlwaysExitOnTab()
addUnknownValues). If false, if the user has typed in a value and hits tab, focus remains in the field. If there is
a match or if addUnknownValues is
true, a value will be added. Otherwise, the input cursor remains at the end of the entered value.
public MultiComboBoxItem setAutoFetchData(java.lang.Boolean autoFetchData)
data source immediately or wait until the
user first opens the pickList.autoFetchData - New autoFetchData value. Default value is falseMultiComboBoxItem instance, for chaining setter callsComboBoxItem.setAutoFetchData(java.lang.Boolean)public java.lang.Boolean getAutoFetchData()
data source immediately or wait until the
user first opens the pickList.ComboBoxItem.getAutoFetchData()public MultiComboBoxItem setAutoFitButtons(java.lang.Boolean autoFitButtons)
layoutStyle is "flow", but false for a
layoutStyle of "vertical" or "verticalReverse". If the layoutStyle is "horizontal" or "horizontalReverse"
then the buttons will autofit regardless of the setting of this property.
autoFitButtons property.autoFitButtons - whether to autofit the buttons. Default value is nullMultiComboBoxItem instance, for chaining setter callspublic java.lang.Boolean getAutoFitButtons()
layoutStyle is "flow", but false for a
layoutStyle of "vertical" or "verticalReverse". If the layoutStyle is "horizontal" or "horizontalReverse"
then the buttons will autofit regardless of the setting of this property.public MultiComboBoxItem setAutoOpenTree(java.lang.String autoOpenTree)
loading data on demand, opens the
top-level node and all of it's direct descendants - otherwise, opens all loaded nodes autoOpenTree - New autoOpenTree value. Default value is "none"MultiComboBoxItem instance, for chaining setter callspublic java.lang.String getAutoOpenTree()
loading data on demand, opens the
top-level node and all of it's direct descendants - otherwise, opens all loaded nodes public IButton getButton()
Using AutoChildren
for details.
An com.smartgwt.client.types.AutoChild attribute used to create the buttons in the MultiComboBoxItem.
public ComboBoxItem getComboBox()
com.smartgwt.client.types.AutoChild attribute to create the combo box in a MultiComboBoxItem.
This component is an AutoChild named "comboBox". For an overview of how to use and
configure AutoChildren, see Using AutoChildren.
public MultiComboBoxItem setComboBoxWidth(int comboBoxWidth)
Note that this attribute only has an effect in "flow", "horizontal", and
"horizontalReverse" modes. In the
other modes, the combo box is as wide as the overall MultiComboBoxItem.
comboBoxWidth - New comboBoxWidth value. Default value is 130MultiComboBoxItem instance, for chaining setter callspublic int getComboBoxWidth()
Note that this attribute only has an effect in "flow", "horizontal", and
"horizontalReverse" modes. In the
other modes, the combo box is as wide as the overall MultiComboBoxItem.
public DynamicForm getComboForm()
DynamicForm holding the comboBox.
This component is an AutoChild named "comboForm". For an overview of how to use and
configure AutoChildren, see Using AutoChildren.
public MultiComboBoxItem setDataSetType(java.lang.String dataSetType)
The default value, "list", will use an instance of the pickListConstructor as the picker - "tree" will show an instance of pickTreeConstructor.
dataSetType - New dataSetType value. Default value is "list"MultiComboBoxItem instance, for chaining setter callspublic java.lang.String getDataSetType()
The default value, "list", will use an instance of the pickListConstructor as the picker - "tree" will show an instance of pickTreeConstructor.
public MultiComboBoxItem setDeselectedButtonStyle(java.lang.String deselectedButtonStyle)
showDeletions is true, the
Button.baseStyle used on buttons for values that have been deleted (also
called "deselected buttons"). If unset, then the baseStyle of deselected buttons is not changed.
NOTE: Deselected buttons are also disabled, so styling should be provided for the
deselectedButtonStyle + "Disabled" style name.
deselectedButtonStyle - New deselectedButtonStyle value. Default value is "buttonDeselected"MultiComboBoxItem instance, for chaining setter callssetPendingButtonStyle(java.lang.String),
CSSStyleNamepublic java.lang.String getDeselectedButtonStyle()
showDeletions is true, the
Button.baseStyle used on buttons for values that have been deleted (also
called "deselected buttons"). If unset, then the baseStyle of deselected buttons is not changed.
NOTE: Deselected buttons are also disabled, so styling should be provided for the
deselectedButtonStyle + "Disabled" style name.
getPendingButtonStyle(),
CSSStyleNamepublic MultiComboBoxItem setDisplayField(java.lang.String displayField)
displayField of the combo box.
Note : This is an advanced setting
setDisplayField in class FormItemdisplayField - New displayField value. Default value is nullMultiComboBoxItem instance, for chaining setter callsComboBoxItem.setDisplayField(java.lang.String)public java.lang.String getDisplayField()
displayField of the combo box.getDisplayField in class FormItemComboBoxItem.getDisplayField()public MultiComboBoxItem setLayoutStyle(MultiComboBoxLayoutStyle layoutStyle)
layoutStyle - the new layout style. Default value is "flow"MultiComboBoxItem instance, for chaining setter callspublic MultiComboBoxLayoutStyle getLayoutStyle()
public MultiComboBoxItem setOptionOperationId(java.lang.String optionOperationId)
optionDataSource, this attribute may be set to specify an explicit DSRequest.operationId when performing a fetch against the option
dataSource to pick up display value mapping.setOptionOperationId in class FormItemoptionOperationId - New optionOperationId value. Default value is nullMultiComboBoxItem instance, for chaining setter callsDatabinding overview and related methodspublic java.lang.String getOptionOperationId()
optionDataSource, this attribute may be set to specify an explicit DSRequest.operationId when performing a fetch against the option
dataSource to pick up display value mapping.getOptionOperationId in class FormItemDatabinding overview and related methodspublic MultiComboBoxItem setPendingButtonStyle(java.lang.String pendingButtonStyle)
showPending is true, the
Button.baseStyle used on buttons that are in the "Pending" visual state.
If unset, then the baseStyle of pending buttons is not changed.
pendingButtonStyle - New pendingButtonStyle value. Default value is "buttonPending"MultiComboBoxItem instance, for chaining setter callssetDeselectedButtonStyle(java.lang.String),
CSSStyleNamepublic java.lang.String getPendingButtonStyle()
showPending is true, the
Button.baseStyle used on buttons that are in the "Pending" visual state.
If unset, then the baseStyle of pending buttons is not changed.
getDeselectedButtonStyle(),
CSSStyleNamepublic MultiComboBoxItem setPickListConstructor(java.lang.String pickListConstructor)
PickListMenu.pickListConstructor - New pickListConstructor value. Default value is "PickListMenu"MultiComboBoxItem instance, for chaining setter callsSCClassName,
PickList overview and related methodspublic java.lang.String getPickListConstructor()
PickListMenu.SCClassName,
PickList overview and related methodspublic MultiComboBoxItem setPickTreeConstructor(java.lang.String pickTreeConstructor)
pickTreeConstructor - New pickTreeConstructor value. Default value is "PickTreeMenu"MultiComboBoxItem instance, for chaining setter callsSCClassNamepublic java.lang.String getPickTreeConstructor()
SCClassNamepublic MultiComboBoxItem setRootNodeId(java.lang.String rootNodeId)
id of the record to use as the root node.rootNodeId - New rootNodeId value. Default value is nullMultiComboBoxItem instance, for chaining setter callspublic java.lang.String getRootNodeId()
id of the record to use as the root node.public MultiComboBoxItem setRootNodeId(java.lang.Integer rootNodeId)
id of the record to use as the root node.rootNodeId - New rootNodeId value. Default value is nullMultiComboBoxItem instance, for chaining setter callspublic java.lang.Integer getRootNodeIdAsInt()
id of the record to use as the root node.public MultiComboBoxItem setShouldSaveValue(java.lang.Boolean shouldSaveValue)
form.getValues()? shouldSaveValue:false is used
to mark formItems which do not correspond to the underlying data model and should not save a value into the form's
values. Example includes visual separators, password
re-type fields, or checkboxes used to show/hide other form items.
A shouldSaveValue:false item should
be given a value either via FormItem.defaultValue or by calling form.setValue(item,
value) or formItem.setValue(value). Providing a
value via form.values or form.setValues() will automatically switch the item to
shouldSaveValue:true.
Note that
setShouldSaveValue in class CanvasItemshouldSaveValue - New shouldSaveValue value. Default value is trueMultiComboBoxItem instance, for chaining setter callspublic java.lang.Boolean getShouldSaveValue()
form.getValues()? shouldSaveValue:false is used
to mark formItems which do not correspond to the underlying data model and should not save a value into the form's
values. Example includes visual separators, password
re-type fields, or checkboxes used to show/hide other form items.
A shouldSaveValue:false item should
be given a value either via FormItem.defaultValue or by calling form.setValue(item,
value) or formItem.setValue(value). Providing a
value via form.values or form.setValues() will automatically switch the item to
shouldSaveValue:true.
Note that
getShouldSaveValue in class CanvasItempublic MultiComboBoxItem setUseInsertionOrder(java.lang.Boolean useInsertionOrder)
displayField.useInsertionOrder - New useInsertionOrder value. Default value is trueMultiComboBoxItem instance, for chaining setter callspublic java.lang.Boolean getUseInsertionOrder()
displayField.public MultiComboBoxItem setValueField(java.lang.String valueField)
valueField of the combo box.setValueField in class FormItemvalueField - New valueField value. Default value is nullMultiComboBoxItem instance, for chaining setter callsComboBoxItem.setValueField(java.lang.String)public java.lang.String getValueField()
valueField of the combo box.getValueField in class FormItemComboBoxItem.getValueField()public Layout getValueLayout()
Using AutoChildren
for details.
The layout used to arrange the comboForm
and the buttons representing the values of the MultiComboBoxItem. Note that the constructor cannot be changed (setting a
valueLayoutConstructor has no effect) because the exact layout class used depends on the current layout style.
public boolean pendingStatusChanged(DynamicForm form, FormItem item, boolean pendingStatus, java.lang.Object newValue, java.lang.Object value)
showPending is
enabled and this MultiComboBoxItem should either clear or show its pending visual state. The default
behavior is that the titleStyle and cellStyle are updated to include/exclude the "Pending"
suffix. In addition, when displayed in the pending state and a pendingButtonStyle is set, then:
useInsertionOrder is
false, buttons for any new values will have their baseStyle set to pendingButtonStyle; otherwise
useInsertionOrder is true) buttons for values will have their baseStyle set to pendingButtonStyle if either the
value is new or it is in a different place within the value array. false will cancel this
default behavior.form - the managing DynamicForm instance.item - the form item itself (also available as "this").pendingStatus - true if the item should show its pending visual state; false otherwise.newValue - the current form item value.value - the value that would be restored by a call to DynamicForm.resetValues().false to cancel the default behavior.public void showValue(java.lang.Object displayValue,
java.lang.Object dataValue,
DynamicForm form,
CanvasItem item)
DynamicForm.setValues() or FormItem.setValue() and may be overridden by CanvasItems
intended to support displaying data values to update the embedded Canvas to reflect the value passed in. The value of a MultiComboBoxItem to the form is an array of valueField values corresponding to the selected combo box options.
displayValue - new display value for the item. This is the value after applying any custom formatter or valueMapdataValue - underlying data value for the itemform - the dynamicForm in which this item is containeditem - the live form item instancepublic static void setDefaultProperties(MultiComboBoxItem multiComboBoxItemProperties)
Note: This method is intended for setting default attributes only and will affect all instances of the underlying class (including those automatically generated in JavaScript). This method should not be used to apply standard EventHandlers or override methods for a class - use a custom subclass instead. Calling this method after instances have been created can result in undefined behavior, since it bypasses any setters and a class instance may have already examined a particular property and not be expecting any changes through this route.
multiComboBoxItemProperties - properties that should be used as new defaults when instances of this class are createdSGWTPropertiespublic IButton getButtonDefaults()
IButton.public void setButtonProperties(IButton buttonProperties)
Note : This is an advanced setting
buttonProperties - buttonPropertiespublic IButton getButtonProperties()
public ComboBoxItem getComboBoxDefaults()
ComboBoxItem in a MultiComboBoxItem.public void setComboBoxProperties(ComboBoxItem comboBoxProperties)
ComboBoxItem.
Note : This is an advanced setting
comboBoxProperties - comboBoxProperties Default value is nullpublic ComboBoxItem getComboBoxProperties()
ComboBoxItem.public MultiComboBoxItem setOptionDataSource(DataSource optionDataSource)
optionDataSource of the combo box.setOptionDataSource in class FormItemoptionDataSource - optionDataSource Default value is nullMultiComboBoxItem
instance, for chaining setter callsComboBoxItem.setOptionDataSource(com.smartgwt.client.data.DataSource)public DataSource getOptionDataSource()
optionDataSource of the combo box.getOptionDataSource in class FormItemComboBoxItem.getOptionDataSource()public final java.lang.String[] getValues()
public void setValues(java.lang.Object... values)