cpr.controls.ComboBox

ComboBox A control that selects a single value from predetermined values. Use a drop-down list.
Hierarchy

Index

Events
Event Description
animationend Event that occurs after the animation ends.
animationstart Event that occurs at the start of the animation.
before-context-value-change Use a bind context in a control that has a bind context An event that occurs before the value changes.
before-selection-change Event that occurs before the selected value is saved by selecting the ComboBox Item.
blur An event that occurs after the control loses focus.
change DOM event that fires when the value changes.
click An event that occurs when the user clicks the control.
close This event occurs when closing the item list.
context-value-change Use a bind context in a control that has a bind context An event that occurs after the value changes.
contextmenu When the right mouse button is clicked or the context menu key is pressed, Event called.
copy Event that occurs when a user copies the text.
cut Event that occurs when a user cuts the text.
dblclick An event that occurs when the user double-clicks the control.
dispose The event that is called when the control is dispose.
dragenter When the mouse pointer enters the elements included in the control while dragging Events that occur.
dragleave During the drag, the mouse pointer may have exited the elements contained in the control.
dragover While dragging the source control with the mouse, the mouse pointer An event that occurs when moving within a region.
drop Drag the source control to the target control while dragging the source control with the mouse.
focus The event that occurs after the control gains focus.
input When the text displayed in the input box is input from the keyboard and changed The event that occurs.
item-click An event that occurs when an item is clicked.
keydown Event raised when the user presses a key.
keyup Event that occurs when the user releases the key.
measure-size Event raised when calculating control size
mousedown When the user presses the mouse button with the pointer over the control Occurs when an event occurs.
mouseenter An event that occurs when the mouse pointer enters the control.
mouseleave If the user moves the mouse pointer beyond the control and its children Events that occur when moving.
mousemove This event is raised when the user moves the pointer over the control.
mouseup The user releases the mouse button while over the control.
open This event occurs when opening the item list.
paste Event that occurs when a user pastes text.
select An event that occurs when the user selects text.
selection-change ComboBox An event that occurs after the selected item is selected to save the selected value.
transitionend Event that fires after CSS property transition ends.
transitionstart Event that fires when CSS property transition starts.
Properties
Name Type Description
accessKey String Returns the keyboard shortcut character.
accessbility Accessbility Gets the accessibility-related ARIA properties or gets the context in which they can be specified.
autoSelect Boolean Returns whether the entire data in the edit area is selected when it is focused.
autoSkip Boolean Returns whether the focus moves to the next control when an item is selected in the list.
buttonImage String Returns an image of button.
dataSet DataCollection Returns the associated dataset.
delimiter String Returns the delimiter when specifying or retrieving multiple selected values.
displayExp #expression Returns the Expression of the text shown on the screen.
displayingText String Gets the value of the HTML Element shown in the input.
disposed Boolean Returns whether the control should be removed.
dropDownType "list" | "tree" Returns the drop-down list type setting value.
editable Boolean Returns whether the value can be changed by user action.
enabled Boolean Returns whether the control is enabled.
enabledItemExp #expression Returns the item's enabled expression value.
fallbackValue String Returns the value to replace with the replacement value.
fieldLabel String Returns the logical field name of the control.
filterExp #expression<(item: cpr.controls.Item)=>Boolean> Returns the value of the expression that filters the item.
fixedListWidth Boolean Returns whether the width of the open list is fixed to the combobox width.
focusable Boolean Returns whether the control is focusable.
focused Boolean Returns whether the control has focus.
hideButton Boolean Returns whether to show or hide the Listbox button.
id String Returns the ID of the control.
itemSetConfig TreeItemSetConfig ItemSet Returns an object with the column name information of the dataset you set.
maxVisibleItems Number Returns the value of the maximum number of list items.
multiple Boolean Returns whether the item is multi-selected.
name String Returns the name of the control.
placeholder String Returns a text (hint) describing the expected value of the InputBox.
preventInput Boolean Returns whether to prevent input through the inputbox.
readOnly Boolean Returns whether a non-modifiable read-only mode is in effect.
selectionViewIndex Number Returns the index position where the selection is shown when the popup is opened.
showIcon Boolean Returns the value of whether to display the item's icon.
style ComboBox$Styler Returns the style settings of the control.
tabIndex Number Returns the control focus sequence using the Tab Key.
text String Returns the text displayed on the screen.
tooltip String Returns a description of the control
treeExpandDepth Number Returns the depth value that automatically opens an item.
type ControlType Returns the signature string of the Control's unique Type that can distinguish the Control.
useFallbackValue Boolean Returns whether to change to an alternate value if it is an invalid value.
uuid String Returns the unique ID of the control.
value String Returns the value of the control.
values String[] Returns an array of values ​​stored in the control when multiple selections are made.
visible Boolean Returns the style property for controlling css visibility.
wheelRowCount Number Returns the number of rows to scroll at a time with the wheel.
Methods
Name Return Type Description
addEventListener Add listeners by EventType to the control.
addEventListenerOnce (e: cpr.events.CEvent)=>Void Add a listener to the control that will run only once per EventType.
addItem Add items.
bind IBindFactory Bind that property.
blur Removes focus from the control.
clearFilter Removes the filter for the item.
clearSelection Deselect all selected items.
close Close the list of combo boxes.
confirmEvent Boolean Determines whether to run the Control's Default Event Handler depending on the state of the Control.
deleteAllItems Remove all items.
deleteItem Remove the item corresponding to the index.
deleteItemByValue Removes the item corresponding to value.
dispatchEvent Boolean Forwards specific events.
dispose Removes the objects that the control contains.
findItem Item Find the first item that meets the criteria.
findItems Item[] Find all items that match your criteria.
findParent UIControl Find the parent control.
focus Assigns focus to the control.
focusNext Moves focus to the next control.
focusPrevious Moves focus to the previous control.
getActualRect Rectangle Gets the bounds value of the control relative to the browser's view port.
getAppInstance AppInstance Returns the App to which the control belongs.
getBindContext BindContext Returns the bind context.
getBindInfo BindInfo Returns the bind property information for the control.
getDataSetIndex Number Returns the index of the dataset as an item.
getDataSetIndexByValue Number Returns the index of the dataset as the value of the item.
getFilter #expression<(item: cpr.controls.Item)=>Boolean> Returns the set filter expression value.
getHtmlAttrNames String[] Returns all custom DOM DATA attribute names.
getIndex Number Returns the Index of the item
getIndexByValue Number Gets the index corresponding to the item's value.
getItem Item Returns the item corresponding to Index.
getItemByValue Item Returns the item corresponding to value.
getItemCount Number Returns the number of items.
getItemEnable Boolean Returns whether an item is active.
getItems Item[] Returns the items.
getItemsByValue Item[] Returns a list of items corresponding to value.
getNextControl UIControl Returns the control to be moved by Tab Key or by the autoskip property.
getOffsetRect Rectangle The area being displayed is obtained based on the parent container to which it belongs.
getParent Container Gets the parent control.
getPrevControl UIControl Shift + Tab Returns the focus to be moved through the key.
getSelectedDataSetIndices Number[] Get the index of the dataset of the selected item.
getSelectedIndices Number[] Get the index of the selected item.
getSelection Item[] Returns the selected items.
getSelectionFirst Item Returns the first data in the selected list data array.
getSelectionLast Item Returns the last data in the selected list data array.
getUserAttrNames String[] Returns all custom attribute names.
getVisualParentControl UIControl Gets the closest parent UI control.
htmlAttr Specifies custom DOM properties.
insertItemAfter Insert the item after the reference item.
insertItemBefore Insert the item before the reference item.
isAvailableBinding Boolean Returns whether the queried property is bindable and the binding has been configured to obtain a valid value.
isBindable Boolean Make sure it is a bindable property.
isFloated Boolean Returns whether the control is floating through an app instance or a specific container.
isOpened Boolean Returns whether the list of combo boxes is open.
isSelected Boolean Returns whether the item corresponding to the index is selected.
isSelectedByValue Boolean Returns whether the item corresponding to value is selected.
isShowing Boolean Returns the status that the screen is showing.
open Open the list of combo boxes.
putValue Sets the value of the control.
putValues Sets the array of values ​​stored in the control when multiple selection is made.
redraw Redraw the control.
removeAllEventListeners Removes all event listeners for the control.
removeAllHtmlAttr Delete all custom DOM DATA attributes.
removeAllUserAttr Delete all custom attributes.
removeEventListener Remove Listener for each EventType in the control.
removeEventListeners Remove all EventType listeners from the control.
removeHtmlAttr Removes the user-defined DOM DATA attribute for a specific attribute name.
removeSelection If an item corresponding to the index is selected, deselect it.
removeSelectionByValue If an item corresponding to value is selected, deselect the item.
removeUserAttr Removes user-defined attributes for a specific attribute name.
selectItem Select the item corresponding to the index.
selectItemByLabel Select the item corresponding to the label.
selectItemByValue Select the item corresponding to value.
selectItems Select items corresponding to the index array.
setBindContext Sets the bind context.
setFilter Use expressions in the list of items to specify filters.
setItemEnable Set whether to activate specific items.
setItemSet Specify the DataSet of the item.
setItems Set up a list of items.
setNextControl Sets the control to be moved by Tab Key or by the autoskip property.
setPrevControl Shift + Tab Set the focus to be moved through the key.
unbind Unbind that property.
userAttr Specifies custom properties.
userData Specifies custom data.
userattr Object Returns a user-defined property.

Constructor

ComboBox(id)
Create a combo box.
Parameters
name type description
idoptional String combo box id

Events

animationend
CAnimationEvent Event that occurs after the animation ends.
animationstart
CAnimationEvent Event that occurs at the start of the animation.
before-context-value-change
CValueChangeEvent Use a bind context in a control that has a bind context An event that occurs before the value changes.
before-selection-change
CSelectionEvent Event that occurs before the selected value is saved by selecting the ComboBox Item. The next event is a selection-change. 
 oldSelection: {cpr.controls.Item []} previously selected item 

 newSelection: {cpr.controls.Item []} item whose selection will be changed
blur
CFocusEvent An event that occurs after the control loses focus.
change
CUIEvent DOM event that fires when the value changes.
click
CMouseEvent An event that occurs when the user clicks the control.
close
CUIEvent This event occurs when closing the item list.
context-value-change
CValueChangeEvent Use a bind context in a control that has a bind context An event that occurs after the value changes.
contextmenu
CMouseEvent When the right mouse button is clicked or the context menu key is pressed, Event called.
copy
CClipboardEvent Event that occurs when a user copies the text.
cut
CClipboardEvent Event that occurs when a user cuts the text.
dblclick
CMouseEvent An event that occurs when the user double-clicks the control.
dispose
CEvent The event that is called when the control is dispose.
dragenter
CMouseEvent When the mouse pointer enters the elements included in the control while dragging Events that occur.
dragleave
CMouseEvent During the drag, the mouse pointer may have exited the elements contained in the control. The event that occurs when.
dragover
CMouseEvent While dragging the source control with the mouse, the mouse pointer An event that occurs when moving within a region.
drop
CMouseEvent Drag the source control to the target control while dragging the source control with the mouse. Event that fires when dropping.
focus
CFocusEvent The event that occurs after the control gains focus.
input
CKeyboardEvent When the text displayed in the input box is input from the keyboard and changed The event that occurs.
item-click
CItemEvent An event that occurs when an item is clicked. 
 item: {cpr.controls.Item} The item object you clicked on.
keydown
CKeyboardEvent Event raised when the user presses a key. Keycode related constants can be referenced at KeyCode.
keyup
CKeyboardEvent Event that occurs when the user releases the key. Keycode related constants can be referenced at KeyCode.
measure-size
CMeasureSizeEvent Event raised when calculating control size
mousedown
CMouseEvent When the user presses the mouse button with the pointer over the control Occurs when an event occurs.
mouseenter
CMouseEvent An event that occurs when the mouse pointer enters the control.
mouseleave
CMouseEvent If the user moves the mouse pointer beyond the control and its children Events that occur when moving.
mousemove
CMouseEvent This event is raised when the user moves the pointer over the control.
mouseup
CMouseEvent The user releases the mouse button while over the control. When an event occurs.
open
CUIEvent This event occurs when opening the item list.
paste
CClipboardEvent Event that occurs when a user pastes text.
select
CUIEvent An event that occurs when the user selects text.
selection-change
CSelectionEvent ComboBox An event that occurs after the selected item is selected to save the selected value. 
 oldSelection: {cpr.controls.Item []} Previously Selected Item 

 newSelection: {cpr.controls.Item []} Item whose selection has changed
transitionend
CTransitionEvent Event that fires after CSS property transition ends.
transitionstart
CTransitionEvent Event that fires when CSS property transition starts.

Properties

accessKey
declaring type AccessableUIControl
type String
get
Returns the keyboard shortcut character.
set
Keyboard shortcut Sets a single character (letter or number).
The shortcut key is [alt] + [shortcut key] for Windows or [option] + [shortcut key] for Mac.
accessbility
declaring type UIControl
type Accessbility
readonly
Gets the accessibility-related ARIA properties or gets the context in which they can be specified.
autoSelect
type Boolean
get
Returns whether the entire data in the edit area is selected when it is focused.
set
Sets whether to select all the data in the edit area when it is in focus.
autoSkip
type Boolean
get
Returns whether the focus moves to the next control when an item is selected in the list.
set
Sets whether to move the focus to the next control when an item is selected in the list.
buttonImage
type String
get
Returns an image of button.
set
Sets the image of the button.
dataSet
type DataCollection
readonly
Returns the associated dataset.
delimiter
type String
get
Returns the delimiter when specifying or retrieving multiple selected values.
set
Sets the delimiter when specifying or importing multiple selected values.
displayExp
type #expression
get
Returns the Expression of the text shown on the screen.
set
Set the expression of the text shown on the screen.
The values ​​provided for Expression are label and value. 
control.displayExp = 'label+"["+value+"]"'
displayingText
type String
readonly
Gets the value of the HTML Element shown in the input.
disposed
declaring type Control
type Boolean
readonly
Returns whether the control should be removed.
dropDownType
type "list" | "tree"
get
Returns the drop-down list type setting value.
set
Set the drop-down list type.
editable
declaring type UIControl
type Boolean
readonly
Returns whether the value can be changed by user action.
UIControl (Output, etc.) that does not allow input returns false.
In the case of an inputtable UIControl, returns true if the binding context in which the value is bound is valid.
Otherwise, it returns false even if it is an inputtable UIControl.

Accordion/Button/Group/Dialog/EmbeddedApp/EmbeddedPage/Grid/HTMLObject/Image/MDIFolder/Menu/
NavigationBar/Notifier/Output/Progress/TabFolder/Shell/FileUpload
In the case of the above control, editable is always false.
enabled
declaring type EnableUIControl
type Boolean
get
Returns whether the control is enabled.
set
Sets whether to activate the control.
enabledItemExp
type #expression
get
Returns the item's enabled expression value.
set
You can set the item's enabled to the column of the dataset bound to the item or the value of label, value. ex) label! = 'label1'
fallbackValue
type String
get
Returns the value to replace with the replacement value.
set
Set the value to be replaced with an alternate value.
fieldLabel
declaring type UIControl
type String
get
Returns the logical field name of the control.
set
Sets the logical field name of the control.
filterExp
type #expression<(item: cpr.controls.Item)=>Boolean>
get
Returns the value of the expression that filters the item.
set
Sets the expression to filter items.
fixedListWidth
type Boolean
get
Returns whether the width of the open list is fixed to the combobox width.
set
Sets whether the width of the list to be opened is fixed to the width of the combo box.
focusable
declaring type UIControl
type Boolean
readonly
Returns whether the control is focusable.
focused
declaring type UIControl
type Boolean
readonly
Returns whether the control has focus.
hideButton
type Boolean
get
Returns whether to show or hide the Listbox button.
set
Listbox Sets whether to show or hide the button.
id
declaring type Control
type String
readonly
Returns the ID of the control.
itemSetConfig
type TreeItemSetConfig
readonly
ItemSet Returns an object with the column name information of the dataset you set.
maxVisibleItems
type Number
get
Returns the value of the maximum number of list items.
set
Set the maximum number of items displayed. The default value is '0', which is displayed at the height set in the listbox. Items are displayed based on the height of the non-newline item.
multiple
type Boolean
get
Returns whether the item is multi-selected.
set
Sets whether to select multiple items.
name
declaring type UIControl
type String
get
Returns the name of the control.
set
Sets the name of the control.
placeholder
type String
get
Returns a text (hint) describing the expected value of the InputBox.
set
Sets a text (hint) that describes the expected value of the InputBox.
preventInput
type Boolean
get
Returns whether to prevent input through the inputbox.
set
Set whether to prevent input through inputbox.
[true]: Prevents keyboard input and operates as a button.
[false]: Keyboard input is possible.
readOnly
declaring type EnableUIControl
type Boolean
get
Returns whether a non-modifiable read-only mode is in effect.
set
Sets whether to enable read-only mode, which can not be modified.
selectionViewIndex
type Number
get
Returns the index position where the selection is shown when the popup is opened.
set
Sets the index position where the selection is displayed when the popup is opened. The default value is '0', which is displayed first.
showIcon
type Boolean
get
Returns the value of whether to display the item's icon.
set
Sets whether to display the item's icon.
style
type ComboBox$Styler
readonly
Returns the style settings of the control.
In case of style changes, only the corresponding control is updated.
Propagation from style changes does not occur.
tabIndex
declaring type AccessableUIControl
type Number
get
Returns the control focus sequence using the Tab Key.
This property controls the tabindex in HTML.
set
Set the control focus order using Tab Key.
This property controls the tabindex in HTML.
text
type String
readonly
Returns the text displayed on the screen.
tooltip
declaring type VisibleUIControl
type String
get
Returns a description of the control
It works when mouse over.
set
Set a description for the control.
It works when mouse over.
treeExpandDepth
type Number
get
Returns the depth value that automatically opens an item.
set
Specifies the depth value for automatically opening items in the treelist. Default is 0. A value of -1 is unlimited. If an item is initially opened due to this attribute, it will not be affected the next time.
type
declaring type Control
type ControlType
readonly
Returns the signature string of the Control's unique Type that can distinguish the Control. Please refer to ControlType for available constant values. For UDC controls, each unique type name is returned. Example: udc.MyUDC
useFallbackValue
type Boolean
get
Returns whether to change to an alternate value if it is an invalid value.
set
Sets whether to change to an alternate value if it is an invalid value.
uuid
declaring type Control
type String
readonly
Returns the unique ID of the control.
value
type String
get
Returns the value of the control.
set
Sets the value of the control.
values
type String[]
get
Returns an array of values ​​stored in the control when multiple selections are made.
set
Sets the array of values ​​stored in the control when multiple selection is made.
visible
declaring type VisibleUIControl
type Boolean
get
Returns the style property for controlling css visibility.
set
Sets the style property to control css visibility.
wheelRowCount
type Number
get
Returns the number of rows to scroll at a time with the wheel.
set
Sets the number of rows to scroll at a time with the wheel.

Methods

addEventListener(type, listener)
declaring typeUIControl
Add listeners by EventType to the control.
Add a listener to the control to handle when a specific event occurs. 
var button = new cpr.controls.Button("btn01");
button.addEventListener("click", function(e) {
// event code...
});
Parameters
name type description
type String
listener (e: cpr.events.CEvent)=>Void
addEventListenerOnce(type, listener)
declaring typeUIControl
Add a listener to the control that will run only once per EventType.
Add a listener to the control to handle when a specific event occurs. The added listener is automatically deleted after running once. Since the object of the added listener is changed, when the listener is deleted It is an object returned after calling addEventListenerOnce and can be deleted. 
var button = new cpr.controls.Button("btn01");
button.addEventListenerOnce("click", function(e) {
// event code...
});
Parameters
name type description
type String
listener (e: cpr.events.CEvent)=>Void
return (e: cpr.events.CEvent)=>Void The modified Listener object.
addItem(item)
Add items.
Value and label such as combo box, list, radio button, and check box group are cpr.controls.Item. Items such as trees, linked listboxes, and linked comboboxes are cpr.controls.TreeItem. Items such as menus and navigation bars are cpr.controls.MenuItem. 
//combobox,list,radiobutton,checkboxgroup
control.addItem(new cpr.controls.Item("label","value"));
//tree,linkedcombobox,linkedlistbox
control.addItem(new cpr.controls.TreeItem("label","value","parentValue"));
//menu,navigationbar
control.addItem(new cpr.controls.MenuItem("label","value","parentValue"));

Parameters
name type description
item Item Item information.
bind(name)
declaring typeUIControl
Bind that property.
Parameters
name type description
name String
return IBindFactory Factory showing bind type.
blur()
declaring typeUIControl
Removes focus from the control.
clearFilter()
Removes the filter for the item.
clearSelection(emitEvent)
Deselect all selected items.
Parameters
name type description
emitEventoptional Boolean defaulttrue Whether to fire an event (before-selection-change, selection-change).
close(emitEvent)
Close the list of combo boxes.
Parameters
name type description
emitEventoptional Boolean defaulttrue Whether to trigger the close event
confirmEvent(e)
Determines whether to run the Control's Default Event Handler depending on the state of the Control.
Parameters
name type description
e CEvent event
return Boolean Whether the control's event handler is running.
deleteAllItems()
Remove all items.
deleteItem(index)
Remove the item corresponding to the index.
Parameters
name type description
index Number Item index
deleteItem(item)
Remove the item.
Parameters
name type description
item Item item
deleteItemByValue(value)
Removes the item corresponding to value.
Parameters
name type description
value String The value of the item
dispatchEvent(e)
declaring typeUIControl
Forwards specific events.
Parameters
name type description
e CEvent
return Boolean Whether to continue processing the default action after propagating the event.
dispose()
Removes the objects that the control contains.
findItem(condition)
Find the first item that meets the criteria. 
control.findItem ({value: "001"}); 

control.findItem ({label: "Seoul"}); 

control.findItem ({value: "001", label: "Seoul"});
Parameters
name type description
condition { label?: String, value?: String, icon?: String, tooltip?: String, parentValue?: String, parentItem?: cpr.controls.TreeItem, depth?: Number } Condition to find item.
return Item The first item that meets the conditions.
findItems(condition)
Find all items that match your criteria. 
control.findItems ({label: "Seoul"});
Parameters
name type description
condition { label?: String, value?: String, icon?: String, tooltip?: String, parentValue?: String, parentItem?: cpr.controls.TreeItem, depth?: Number } Condition to find item.
return Item[] An array of all items that meet the condition.
findParent(predicate, includeSelf)
declaring typeUIControl
Find the parent control.
If includeSelf is true, the parent including the self is found.
Parameters
name type description
predicate (c: cpr.controls.UIControl)=>Boolean
includeSelfoptional Boolean defaultfalse Whether you include yourself.
return UIControl Parental control.
focus(forward)
declaring typeUIControl
Assigns focus to the control.
Parameters
name type description
forwardoptional Boolean defaulttrue
focusNext()
declaring typeUIControl
Moves focus to the next control. If there are multiple structural elements that have focus inside a control, focus may transition to the next element.
focusPrevious()
declaring typeUIControl
Moves focus to the previous control. If there are multiple structural elements that have focus inside a control, focus may transfer to the previous element.
getActualRect()
declaring typeUIControl
Gets the bounds value of the control relative to the browser's view port. If the control is not drawn on the screen, an object with all values ​​of 0 is returned.
return Rectangle About the position and size of controls in the HTML DOM
getActualRect(includeWrap)
declaring typeUIControl
Gets the bounds value of the control relative to the browser's view port. If the control is not drawn on the screen, an object with all values ​​of 0 is returned.
Parameters
name type description
includeWrap Boolean If this value is true, the layout of the parent group gets the area of ​​the node surrounding this control. If false, only get the area of ​​the control node.
return Rectangle About the position and size of controls in the HTML DOM
getActualRect(options)
declaring typeUIControl
Gets the bounds value of the control relative to the browser's view port. If the control is not drawn on the screen, an object with all values ​​0 is returned.
Parameters
name type description
options { includeWrap?: Boolean, scaled?: Boolean }
return Rectangle
getAppInstance()
declaring typeUIControl
Returns the App to which the control belongs.
return AppInstance App that belongs
getBindContext()
declaring typeUIControl
Returns the bind context.
return BindContext bind context
getBindInfo(name)
declaring typeUIControl
Returns the bind property information for the control.
Parameters
name type description
name String
return BindInfo BindInfo Properties
getDataSetIndex(item)
Returns the index of the dataset as an item.
Parameters
name type description
item Item
return Number
getDataSetIndexByValue(value)
Returns the index of the dataset as the value of the item.
Parameters
name type description
value String
return Number
getFilter()
Returns the set filter expression value.
return #expression<(item: cpr.controls.Item)=>Boolean>
getHtmlAttrNames()
declaring typeUIControl
Returns all custom DOM DATA attribute names.
return String[] An array of all custom DOM DATA attribute names.
getIndex(item)
Returns the Index of the item
For nonexistent items, returns -1.
Parameters
name type description
item Item Item information.
return Number Index of corresponding item.
getIndexByValue(value)
Gets the index corresponding to the item's value.
Parameters
name type description
value String The value of the item
return Number The index of the corresponding item.
getItem(index)
Returns the item corresponding to Index.
Parameters
name type description
index Number The index of the item.
return Item Corresponding item.
getItemByValue(value)
Returns the item corresponding to value.
Parameters
name type description
value String The value of the item.
return Item Corresponding item.
getItemCount()
Returns the number of items.
return Number Number of items.
getItemEnable(item)
Returns whether an item is active.
Parameters
name type description
item Item item.
return Boolean Whether the item is active.
getItems()
Returns the items. Gets the filtered List if Filter is applied.
return Item[] An array of items.
getItemsByValue(value)
deprecatedIt is not used because duplicate values ​​are not allowed. Please use getItemByValue.
Returns a list of items corresponding to value.
Parameters
name type description
value String The value of the item.
return Item[] An array of corresponding items.
getNextControl()
declaring typeUIControl
Returns the control to be moved by Tab Key or by the autoskip property.
return UIControl control.
getOffsetRect(includeWrap)
declaring typeUIControl
The area being displayed is obtained based on the parent container to which it belongs.
Parameters
name type description
includeWrapoptional Boolean defaultfalse If this value is true, the layout of the parent group gets the area of ​​the node surrounding this control. If false, only get the area of ​​the control node.
return Rectangle
getParent()
declaring typeUIControl
Gets the parent control.
return Container Parental control.
getPrevControl()
declaring typeUIControl
Shift + Tab Returns the focus to be moved through the key.
return UIControl control.
getSelectedDataSetIndices()
Get the index of the dataset of the selected item. Returns -1 if it is not an item in the dataset.
return Number[]
getSelectedIndices()
Get the index of the selected item.
return Number[]
getSelection()
Returns the selected items.
return Item[] An array of selected items.
getSelectionFirst()
Returns the first data in the selected list data array.
return Item The first selected data.
getSelectionLast()
Returns the last data in the selected list data array.
return Item Last selected data.
getUserAttrNames()
declaring typeControl
Returns all custom attribute names.
return String[] An array of all custom attribute names.
getVisualParentControl()
declaring typeUIControl
Gets the closest parent UI control. Unlike getParent(), it finds nearby parent controls, including external apps.
return UIControl
htmlAttr(key, value)
declaring typeUIControl
Specifies custom DOM properties.
Parameters
name type description
key String The attribute name to assign
value String The attribute value to specify.
htmlAttr(key)
declaring typeUIControl
Returns a custom DOM property.
Parameters
name type description
key String The attribute name to get.
return String Custom properties.
htmlAttr(values)
declaring typeUIControl
Specify multiple custom DOM properties at once.
Parameters
name type description
values {[key:string]: String} A JSON object containing custom attribute keys/values.
htmlAttr()
declaring typeUIControl
Get all custom DOM properties in the form of a map.
return {[key:string]: String}
insertItemAfter(item, offset)
Insert the item after the reference item.
Parameters
name type description
item Item The item you want to insert.
offset Item Item to be standardized.
insertItemBefore(item, offset)
Insert the item before the reference item.
Parameters
name type description
item Item The item you want to insert.
offset Item Item to be standardized.
isAvailableBinding(name)
declaring typeUIControl
Returns whether the queried property is bindable and the binding has been configured to obtain a valid value. Even if no binding is configured and a simple value is specified, it is treated as configured so that a valid value is obtained. For example, binding to a row index that does not exist in the DataSet is an invalid binding.
Parameters
name type description
name String
return Boolean
isBindable(name)
declaring typeUIControl
Make sure it is a bindable property.
Parameters
name type description
name String
return Boolean Confirmation.
isFloated()
declaring typeUIControl
Returns whether the control is floating through an app instance or a specific container.
return Boolean
isOpened()
Returns whether the list of combo boxes is open.
return Boolean
isSelected(index)
Returns whether the item corresponding to the index is selected.
Parameters
name type description
index Number Item index
return Boolean Whether to select the item at the index.
isSelected(item)
Returns whether the applicable item is selected.
Parameters
name type description
item Item item
return Boolean Whether or not the item is selected.
isSelectedByValue(value)
Returns whether the item corresponding to value is selected.
Parameters
name type description
value String The value of the item.
return Boolean Whether or not the item is selected.
isShowing()
declaring typeUIControl
Returns the status that the screen is showing. Returns false if the visible state of all parents including itself is false.
return Boolean
open(emitEvent)
Open the list of combo boxes.
Parameters
name type description
emitEventoptional Boolean defaulttrue Whether to trigger open event
putValue(value)
Sets the value of the control.
Parameters
name type description
value String The value of the control.
putValues(values)
Sets the array of values ​​stored in the control when multiple selection is made.
Parameters
name type description
values String[] An array of values ​​to be stored in the control.
redraw()
declaring typeUIControl
Redraw the control.
removeAllEventListeners()
declaring typeControl
Removes all event listeners for the control.
removeAllHtmlAttr()
declaring typeUIControl
Delete all custom DOM DATA attributes.
removeAllUserAttr()
declaring typeControl
Delete all custom attributes.
removeEventListener(type, listener)
declaring typeControl
Remove Listener for each EventType in the control. 
control.removeEventListener ('click', listener);
Parameters
name type description
type String Event type.
listener (e: cpr.events.CEvent)=>Void Event listeners.
removeEventListeners(type)
declaring typeControl
Remove all EventType listeners from the control. 
control.removeEventListeners ('click');
Parameters
name type description
type String Event type.
removeHtmlAttr(key)
declaring typeUIControl
Removes the user-defined DOM DATA attribute for a specific attribute name.
Parameters
name type description
key String The custom DOM DATA attribute name to remove.
removeSelection(index, emitEvent)
If an item corresponding to the index is selected, deselect it.
Parameters
name type description
index Number Index of items to deselect
emitEventoptional Boolean Whether to fire an event (before-selection-change, selection-change).
removeSelection(item, emitEvent)
If the corresponding item is selected, deselect it.
Parameters
name type description
item Item Item to deselect
emitEventoptional Boolean Whether to fire an event (before-selection-change, selection-change).
removeSelectionByValue(value, emitEvent)
If an item corresponding to value is selected, deselect the item.
Parameters
name type description
value String The value of the item.
emitEventoptional Boolean defaulttrue Whether to fire an event (before-selection-change, selection-change).
removeUserAttr(key)
declaring typeControl
Removes user-defined attributes for a specific attribute name.
Parameters
name type description
key String The custom attribute name to remove.
selectItem(index, emitEvent)
Select the item corresponding to the index.
The value of the selected item is assigned as the value of the control. 
control.selectItem (0);
Parameters
name type description
index Number Index of the item to be selected.
emitEventoptional Boolean Whether to fire an event (before-selection-change, selection-change).
selectItem(item, emitEvent)
Select the applicable item.
The value of the selected item is assigned as the value of the control. 
control.selectItem (item);
Parameters
name type description
item Item The item you want to select.
emitEventoptional Boolean Whether to fire an event (before-selection-change, selection-change).
selectItemByLabel(label, emitEvent)
Select the item corresponding to the label.
The value of the selected item is assigned as the value of the control. 
control.selectItemByLabel ("label1");
Parameters
name type description
label String The label of the item.
emitEventoptional Boolean defaulttrue Whether to fire an event (before-selection-change, selection-change).
selectItemByValue(value, emitEvent)
Select the item corresponding to value.
The value of the selected item is assigned as the value of the control. 
control.selectItemByValue ("value1");
Parameters
name type description
value String The value of the item.
emitEventoptional Boolean defaulttrue Whether to fire an event (before-selection-change, selection-change).
selectItems(indices, emitEvent)
Select items corresponding to the index array. Deselect the previously selected items and select the items.
Parameters
name type description
indices Number[] Index array of items to select
emitEventoptional Boolean Whether to fire an event (before-selection-change, selection-change).
selectItems(items, emitEvent)
Select those items. Deselects previously selected items and selects them.
Parameters
name type description
items Item[] Array of items to select
emitEventoptional Boolean Whether to fire an event (before-selection-change, selection-change).
setBindContext(context)
declaring typeUIControl
Sets the bind context. 
container.setBindContext({dataControl:grid.dataSet,rowIndex:rowIndex})
Parameters
name type description
context BindContext bind context
setFilter(condition)
Use expressions in the list of items to specify filters. 
control.setFilter ("value == 'value1'");
Parameters
name type description
condition #expression<(item: cpr.controls.Item)=>Boolean> Filter conditions.
setItemEnable(item, enabled)
Set whether to activate specific items.
Parameters
name type description
item Item item.
enabled Boolean Whether to activate.
setItemSet(dataSet, config)
Specify the DataSet of the item. 
 Dataset1.parsedata ({{
Of
	Columns: [
		{Datatype: "String", name: "Dataset_value"},
		{Datatype: "String", name: "dataset_label"},
	],
Of
});
Control.SetitemSet (Dataset1, {Value: "Dataset_value", Label: "Dataset_label"})
Parameters
name type description
dataSet DataCollection
config TreeItemSetConfig Set items to connect.
setItems(items)
Set up a list of items.
Parameters
name type description
items Item[] An array of items.
setNextControl(nextControl)
declaring typeUIControl
Sets the control to be moved by Tab Key or by the autoskip property.
Parameters
name type description
nextControl UIControl control.
setPrevControl(prevControl)
declaring typeUIControl
Shift + Tab Set the focus to be moved through the key.
Parameters
name type description
prevControl UIControl control.
unbind(name)
declaring typeUIControl
Unbind that property.
Parameters
name type description
name String
userAttr(key, value)
declaring typeControl
Specifies custom properties.
Parameters
name type description
key String The attribute name to assign
value String The attribute value to specify.
userAttr(key)
declaring typeControl
Returns a user-defined property.
Parameters
name type description
key String The attribute name to get.
return String Custom properties.
userAttr(values)
declaring typeControl
Specify multiple custom properties at once.
Parameters
name type description
values {[key:string]: String} A JSON object containing custom attribute keys/values.
userAttr()
declaring typeControl
Get all custom properties in the form of a map.
return {[key:string]: String}
userData(key, value)
declaring typeControl
Specifies custom data. Unlike user-defined attributes, you can use arbitrary types in addition to strings. When the control is dispose, all custom data is removed.
Parameters
name type description
key String The key of the data to be specified.
value Object Data to specify.
userData(key)
declaring typeControl
get custom data
Parameters
name type description
key String The key of the data to get.
return Object
userData(override)
declaring typeControl
Specifies multiple user-defined data.
Parameters
name type description
override {[key:string]: Object} A JSON object containing user-defined data.
userData()
declaring typeControl
Get all your custom data.
return {[key:string]: Object}
userattr()
declaring typeControl
deprecatedPlease use userAttr.
Returns a user-defined property.
return Object Custom properties.