new RadioButtonGroup()
This constructor is never used explicitly.
Extends
Members
Methods
-
inherited addClass(name, replaced)
-
Add/replace CSS class(es) for this control
Name Type Description name
string CSS class name(s) to add to the control. Separate class names by a space if more than one class. replaced
string optional CSS class name(s) to be replaced by the first argument. Separate class names by a space if more than one class. Example
Button.addClass("green");
-
appendItem(value, displayText){object}
-
Appends an item to the selection list
Name Type Description value
* The value of the selection displayText
string The text to be displayed Returns:
Type Description object Item that was added to the list -
clearItems()
-
Clears the selection list
-
inherited getData(){Object}
-
Retrieve bound data associated this view/control. Only works for views/controls with bound data.
Returns:
Type Description Object Value of bound data. undefined
if the view has no data binding.Example
var dec1 = MyDecimal.getData();
-
getItemCount(){integer}
-
Get number of items in the list
Returns:
Type Description integer -
getItemText(itemVal){string}
-
Get the display text for a value (value must be known)
Name Type Description itemVal
ANY Value of item to get text for Returns:
Type Description string Examples
rdbtgrp.getItemText("Key1") // returns "Option 1" (for a selection item with value="Key1" and name="Option 1")
rdbtgrp.getItemText(rdbtgrp.getSelectedItem()) // returns the text of the selected item
-
getItemTextAt(index){string}
-
Get display text associated with item at specified index
Name Type Description index
integer Index of item/option in radio button group control Returns:
Type Description string -
getLabel(){string}
-
Get label associated with radio button group control
Returns:
Type Description string -
getLabelPlacement(){string}
-
Get label placement for control. NOTE: This always returns the label placement as set, to avoid ambiguity always set the label placement using "T"|"L"|
Returns:
Type Description string -
getSelectedIndex(){Array.<integer>}
-
Get index of item selected in radio button group control
Returns:
Type Description Array.<integer> -
getSelectedItem(){Array.<ANY>}
-
Get value associated with item selected in radio button group control, or null
Returns:
Type Description Array.<ANY> -
getServiceInputData(){ANY}
-
Returns the input for the list items AJAX service
Returns:
Type Description ANY -
getType(){string}
-
Get descriptive string representing the type of control
Returns:
Type Description string -
inherited hide(collapseFlag)
-
Hide this view/control
Name Type Description collapseFlag
boolean Set to true
to collapse the view (equivalent to a view setting of "NONE")Example
MyView.hide();
-
inherited isBound(){boolean}
-
Indicates bound status of control.
Returns:
Type Description boolean True if the control is bound to coach data. -
inherited isEnabled(){boolean}
-
Checks if the view is enabled or not
Returns:
Type Description boolean Enabled status Example
var enabled = MyView.isEnabled();
-
isLabelVisible(){boolean}
-
Get label visibility for radio button group control
Returns:
Type Description boolean -
inherited isValid(){boolean}
-
Returns the valid status as last set by the setValid() method.
Returns:
Type Description boolean Validity status. true
ifsetValid(false, ...)
was never calledExample
var valid = MyView.isValid();
-
inherited isVisible(){boolean}
-
Checks whether or not view is visible
Returns:
Type Description boolean Visibility status Example
var visible = MyView.isVisible();
-
inherited propagateUpValueChange(event){boolean}
-
Propagates value change of control up through parent views
Name Type Description event
Event Value change event (usually an onchange event) Returns:
Type Description boolean True if a formula update was triggered on the control's parent, otherwise false Example
MyView.propagateUp(event);
-
inherited recalculate()
-
Only for formula-enabled views!
Explicitly triggers the re-evaluation of the formula for this view (if a formula has been specified). If the view is not formula-enabled,recalculate()
does nothing.Example
Text1.recalculate(); //If the formula for Text1 is: new Date().toString(), Text1 is updated to the current date/time
-
reloadServiceItems(input)
-
Sets tab index of radio button group control
Name Type Description input
ANY Data to be passed to the AJAX Service retrieving the items for the control -
removeItem(value)
-
Remove the first item/option matching the value specified
Name Type Description value
* Value of item/option in radio button group control Examples
rdbtgrp.removeItem("Key1") // removes "Option 1" (for a selection item with value="Key1" and name="Option 1")
rdbtgrp.removeItem(rdbtgrp.getSelectedItem()) // removes selected item
-
removeItemAt(index)
-
Remove item at specified index
Name Type Description index
integer Index of item/option in radio button group control -
inherited setData(value)
-
Set/update bound data associated this view/control. Only works for views/controls with bound data.
Name Type Description value
Object Value of bound data. The type of this parameter must match the type of the bound data. Example
MyView.setData("TEST"); //Updates bound data to the string 'TEST'
-
inherited setEnabled(enabled, required)
-
Enable/disable this view/control
Name Type Description enabled
boolean Enabled/read-only flag ( true
to enable view,false
to disable/make read-only)required
boolean Enable/disable required field flag for control Example
MyView.setEnabled(false); //Make MyView read-only
-
setItem(idx, value, text)
-
Set display text of item/option at specified index
Name Type Description idx
integer Index to set value
ANY Value of item/option in radio button group control text
string The display text to show for the item/option -
setItemText(value, text)
-
Set display text of the first item/option matching the value specified
Name Type Description value
ANY Value of item/option in radio button group control text
string The display text to show for the item/option Example
rdbtgrp.setItemText("Key1") // sets display text to "Option 1" (for a selection item with value="Key1" and name="Option 1")
-
setLabel(label)
-
Set label for radio button group control
Name Type Description label
string Label for the control -
setLabelPlacement(placement)
-
Set label placement for control. NOTE: to avoid ambiguity always set the label placement using "T"|"L"|
Name Type Description placement
string "T"|"TOP"=Top | "L"|"LEFT"=Left -
setLabelVisible(flag)
-
Set label visibility for radio button group control
Name Type Description flag
boolean {true | false} Set to false to hide label -
setSelectedItem(key)
-
Set item selected in radio button group control based on the key of the item/option
Name Type Description key
ANY Key of item to set selection to -
setServiceInputData(data)
-
Specifies the default input for the list items AJAX service
Name Type Description data
ANY Default input data for service -
inherited setValid(valid, errorText)
-
Flag this view/control as valid or invalid
Name Type Description valid
boolean Valid/invalid flag ( true
to set view valid,false
to make it invalid - which typically shows the view with "invalid" styling and indicator)errorText
string Validation error text to show on the invalid-styled view Example
MyView.setValid(false, "Please fix your data entry"); //Make MyView invalid
-
inherited setVisible(visible, collapse)
-
Show/hide this view/control
Name Type Description visible
boolean Visibility flag ( true
to show view,false
to hide)collapse
boolean Set to true
to collapse the control space whenvisible
is set tofalse
.Examples
MyView.setVisible(false, false); //Equivalent to MyView.hide()
MyView.setVisible(false, true); // Sets visibility to "None"
-
Show this view/control
Example
MyView.show();
-
inherited triggerFormulaUpdates(phase)
-
Broadcasts the expression trigger for the specified view
Name Type Default Description phase
int bpmext.ui.PHASE_NORMAL optional The phase we are currently in Example
MyView.triggerFormulaUpdates();