FormSelectField¶
Definition¶
Extends¶
Extended By¶
None
Description¶
A special type of field within a FormPanel that allows multiple options as a dropdown
Method Summary¶
| Owner | Name | Return Type | Description |
|---|---|---|---|
| FormSelectField | addOptions(options) | Boolean | Add to the field's options based on the provided map |
| FormSelectField | clearOptions() | Boolean | Removes all options. |
| FormField | exportConfig() | Map | Exports this field's configuration to a map. |
| FormField | focus() | Boolean | Requests user input be focused on this field, will make panel visible if necessary. Returns false if this field can not be focused. Note that the focus is not immediate, meaning a call to isFocused() directly after calling focus may still return false |
| DashboardResource | getCallback(callbackName) | Callback | Returns a callback by name |
| DashboardResource | getCallbacks() | Map | Returns a map of all callback definitions. |
| DashboardResource | getChildren() | List | Returns a list of the child dashboard resources. |
| Object | getClassName() | String | Returns the string name of this object's class type. |
| FormField | getCssClass() | String | Returns the CSS class. |
| DashboardResource | getDRI() | String | Returns the Dashboard Resource Indicator (DRI) as a string. DRI is the unique identifier of this resources within the entire dashboard. |
| DashboardResource | getDashboardResourceType() | String | Returns the Dashboard Resource Type as a string |
| FormField | getDisabled() | Boolean | Returns true if field is disabled, false otherwise. |
| FormField | getDisplayMode() | String | DEPRECATED, use isVisible instead. Returns display type of field. Will return "ABSOLUTE" if field is displayed using absolute positioning. Will return "HTML" if field is displayed using form HTML. |
| FormSelectField | getDisplayValueSortOption() | String | Returns the sort option set for the display values. |
| FormField | getFieldValue(varName) | Object | Returns the value of the field with the associated varName for the form that owns this field. |
| DashboardResource | getFormula(formulaName) | Formula | Returns a Formula given the formula name. |
| DashboardResource | getFormulaNames() | Set | Returns a set of the names of all formulas for this object. |
| DashboardResource | getFormulas() | Map | Returns a map of all available formulas for this object. The key is the formula name. |
| DashboardResource | getLRI() | String | Returns the Localized Resource Indicator (LRI) as a string. LRI is the unique identifier of this resource with the parent element. |
| FormField | getLabel() | String | Returns the label associated with this field. |
| FormField | getLabelTooltip() | String | Returns the tooltip associated with this field's label. |
| FormSelectField | getOption(key) | String | Returns a single option according to input key |
| FormSelectField | getOptions() | Map | Returns the map of options |
| DashboardResource | getOwner() | DashboardResource | Returns the DashboardResource that owns this object. |
| FormField | getPanel() | FormPanel | Returns the panel that contains this field. |
| FormField | getPosition() | Rectangle | Returns a Rectangle object representing the field's position as (x,y,w,h). |
| FormField | getStyleSet() | StyleSet | Returns the StyleSet for this form field. |
| FormSelectField | getValue() | String | Returns the selected value of this field, null if nothing is selected. |
| FormField | getVariableName() | String | Returns the variable name associated with this field. |
| DashboardResource | invokeCallback(callbackName, args) | Object | Executes the specified callback definition and returns the result from the callback. |
| FormField | isAtDefaultPosition() | Boolean | Returns whether field is at the default position specified in field editor. |
| FormField | isFocused() | Boolean | Returns true if this field has focus, false otherwise. |
| FormField | isTransient() | Boolean | Returns whether a field is transient. |
| FormField | isVisible() | Boolean | Returns true if this field is visible, false otherwise. |
| FormSelectField | putOption(key, value) | Boolean | Adds an option to the multi-select field. |
| FormSelectField | removeOption(key) | Boolean | Removes the option from the select field. |
| FormField | resetCssClass() | Boolean | Resets CSS class to default (as configured in AMI editor). |
| FormField | resetDisabled() | Boolean | Resets the disabled flag to default (as configured in AMI editor). |
| FormSelectField | resetOptions() | Object | If options have been manually set using amiscript, this resets to default values |
| FormField | resetPosition() | Boolean | Resets field position to default position specified in field editor. |
| FormField | setCssClass(cssStyle) | Boolean | Sets CSS class. Returns empty string for no css. |
| FormField | setDisabled(disabled) | Boolean | Set the disabled status of the field (true for disabling, false for enabling). |
| FormField | setDisplayMode(mode) | Boolean | DEPRECATED, use setVisible instead. Sets display mode of field. Setting to "ABSOLUTE" will display field using absolute positioning. Setting to "HTML" will allow field to be displayed using the form HTML. Any other input will throw an exception. |
| FormSelectField | setDisplayValueSortOption(displaySortOption) | Boolean | Sets the sorting option for the display values in the autocomplete menu. |
| FormField | setFieldValue(key, value) | Boolean | Sets the key value pair to this portlet's attributes and returns true if successful. For key, put in the field's variable name, then set the value. |
| FormField | setLabelTooltip(tooltip) | Boolean | Sets the label tooltip. |
| FormSelectField | setOptions(options) | Boolean | Set the field's options using the provided map |
| FormField | setPosition(x, y, w, h) | Boolean | Sets the field position. Specify (x,y) position, width, and height in pixels. Passing null to an argument is equivalent to not setting a value for that specific argument. |
| FormField | setPosition(rect) | Boolean | Sets the position, if the position is null then resets the overrides |
| FormField | setValue(value) | Boolean | Set this field's value. This is a generic set method that is available for every field in AMI. For FormRangeSlider and FormImage field, it is advisable to use their own setValue() method. |
| FormField | setVisible(visible) | Boolean | Sets the visibility of this field. Returns false iff the argument is null, true otherwise. |
| Object | toJson() | String | Returns a json representation of this object. |
Method Definitions¶
addOptions(options)¶
Boolean FormSelectField::addOptions(Map options)
Description¶
Add to the field's options based on the provided map
Parameter Definition¶
| Name | Type | Description |
|---|---|---|
| options | Map | Options to be added |
clearOptions()¶
Boolean FormSelectField::clearOptions()
Description¶
Removes all options.
getDisplayValueSortOption()¶
String FormSelectField::getDisplayValueSortOption()
Description¶
Returns the sort option set for the display values.
getOption(key)¶
String FormSelectField::getOption(Object key)
Description¶
Returns a single option according to input key
Parameter Definition¶
| Name | Type | Description |
|---|---|---|
| key | Object | Key for which the corresponding option is returned |
getOptions()¶
Map FormSelectField::getOptions()
Description¶
Returns the map of options
getValue()¶
String FormSelectField::getValue()
Description¶
Returns the selected value of this field, null if nothing is selected.
putOption(key,value)¶
Boolean FormSelectField::putOption(Object key, String value)
Description¶
Adds an option to the multi-select field.
Parameter Definition¶
| Name | Type | Description |
|---|---|---|
| key | Object | Key to be added |
| value | String | Value to be added |
removeOption(key)¶
Boolean FormSelectField::removeOption(Object key)
Description¶
Removes the option from the select field.
Parameter Definition¶
| Name | Type | Description |
|---|---|---|
| key | Object | Key to be removed |
resetOptions()¶
Object FormSelectField::resetOptions()
Description¶
If options have been manually set using amiscript, this resets to default values
setDisplayValueSortOption(displaySortOption)¶
Boolean FormSelectField::setDisplayValueSortOption(String displaySortOption)
Description¶
Sets the sorting option for the display values in the autocomplete menu.
Parameter Definition¶
| Name | Type | Description |
|---|---|---|
| displaySortOption | String | Expected Values: NONE (original ordering), ASC, DESC |
setOptions(options)¶
Boolean FormSelectField::setOptions(Map options)
Description¶
Set the field's options using the provided map
Parameter Definition¶
| Name | Type | Description |
|---|---|---|
| options | Map | Options to be added |