JavaSwingList¶
Java Swing List.
UI element class: javax.swing.JList
Extends JavaObject
Extends SeSSimulatedObject
Behavior Pattern: JavaSwingObjectListSelectableBehavior
Property Summary¶
| Property | Description | Getter | Setter |
|---|---|---|---|
| ItemCount | Number of items. | GetItemCount | |
| ItemIndexByName | Returns item index by its name. | GetItemIndexByName | |
| ItemNameByIndex | Returns item name by its index. | GetItemNameByIndex | |
| SelectedIndex | Index of the selected element of the object. | GetSelectedIndex | SetSelectedIndex |
| SelectedIndices | Returns string of indexes delimited by separator or array of indexes of selected elements. | GetSelectedIndices | |
| SelectedItems | Text of all the selected items in a single string. | GetSelectedItems | |
| SelectedText | Text of the selected item in a single string. | GetSelectedText | |
| SelectionCount | Number of selected items. | GetSelectionCount |
Action Summary¶
| Action | Description |
|---|---|
| DoAddSelection | Extends selection. |
| DoClearSelection | Clears selection. |
| DoRemoveSelection | Removes selection from specified items. |
| DoSelectItem | Selects items of this object. |
Property Detail¶
ItemCount¶
Number of items.
Type: number
Accessors: GetItemCount
ItemIndexByName¶
Returns item index by its name. 'false' if name is not found.
Getter Parameters:
| Name | Type | Description |
|---|---|---|
| name | string |
Type: number|boolean
Accessors: GetItemIndexByName
ItemNameByIndex¶
Returns item name by its index.'false' if name is not found.
Getter Parameters:
| Name | Type | Description |
|---|---|---|
| index | number | Index of the item |
Type: string|boolean
Accessors: GetItemNameByIndex
SelectedIndex¶
Index of the selected element of the object.
Type: number
Accessors: GetSelectedIndex, SetSelectedIndex
SelectedIndices¶
Returns string of indexes delimited by separator or array of indexes of selected elements.
Getter Parameters:
| Name | Type | Description |
|---|---|---|
| asArray | boolean | If set to true, function returns an array. |
| separator | string | Separator character. Possible values: ";", ",", "\", "/" Optional, Default: ";". |
Type: string
Accessors: GetSelectedIndices
SelectedItems¶
Text of all the selected items in a single string. Items are divided by ';' separator.
Type: string
Accessors: GetSelectedItems
SelectedText¶
Text of the selected item in a single string.
Getter Parameters:
| Name | Type | Description |
|---|---|---|
| separator | string | Separator character. Possible values: ";", ",", "\", "/" Optional, Default: ";". |
Type: string
Accessors: GetSelectedText
SelectionCount¶
Number of selected items.
Type: number
Accessors: GetSelectionCount
Action Detail¶
DoAddSelection¶
Extends selection.
DoAddSelection(items, separator, itemsType)
Parameters:
| Name | Type | Description |
|---|---|---|
| items | number | string | array | Can be one of the following: 1. Number, index of an item. 2. String, item names delimited with separator. 3. String, item indexes delimited with separator. 4. Array of item names. 5. Array of item indexes. |
| separator | string | Separator character. Possible values: ";", ",", "\", "/" Optional, Default: ";". |
| itemsType | string | If it is 'name' and 'items' parameter is of Stringtype then 'items' parameter is treated as separated item names. If it is'index' and 'items' parameter is of String type then'items' parameter istreated as separated item indexes. If any other value is passed as 'itemsType'the behavior is undefined. Optional. |
Returns:
boolean: 'true' if success, 'false' otherwise.
DoClearSelection¶
Clears selection.
DoClearSelection()
Returns:
boolean: 'true' if success, 'false' otherwise.
DoRemoveSelection¶
Removes selection from specified items.
DoRemoveSelection(items, separator, itemsType)
Parameters:
| Name | Type | Description |
|---|---|---|
| items | number | string | array | Can be one of the following: 1. Number, index of an item. 2. String, item names delimited with separator. 3. String, item indexes delimited with separator. 4. Array of item names. 5. Array of item indexes. |
| separator | string | Separator character. Possible values: ";", ",", "\", "/" Optional, Default: ";". |
| itemsType | string | If it is 'name' and 'items' parameter is of Stringtype then 'items' parameter is treated as separated item names. If it is'index' and 'items' parameter is of String type then'items' parameter istreated as separated item indexes. If any other value is passed as 'itemsType'the behavior is undefined. Optional. |
Returns:
boolean: 'true' if success, 'false' otherwise.
DoSelectItem¶
Selects items of this object. First it clears existing selection.
DoSelectItem(items, separator, itemsType)
Parameters:
| Name | Type | Description |
|---|---|---|
| items | number | string | array | Can be one of the following: 1. Number, index of an item. 2. String, item names delimited with separator. 3. String, item indexes delimited with separator. 4. Array of item names. 5. Array of item indexes. |
| separator | string | Separator character. Possible values: ";", ",", "\", "/" Optional, Default: ";". |
| itemsType | string | If it is 'name' and 'items' parameter is of Stringtype then 'items' parameter is treated as separated item names. If it is'index' and 'items' parameter is of String type then'items' parameter istreated as separated item indexes. If any other value is passed as 'itemsType'the behavior is undefined. Optional. |
Returns:
boolean: 'true' if success, 'false' otherwise.