Skip to content

C1TrueDBListCombo

Component One True DB Combo Control

Extends ActiveXObject

Extends SeSSimulatedObject

Behavior Pattern: C1TrueDBListBehavior

Property Summary

Property Description Getter Setter
Cell Text of the specified cell. GetCell
ColumnCount Number of columns in the table. GetColumnCount
ColumnName Caption of a column. GetColumnName
ItemCount Number of items. GetItemCount
ItemIndexByName Returns item index by its name. GetItemIndexByName
ItemNameByIndex Returns item name by its index. GetItemNameByIndex
RowCount Number of rows in the table. GetRowCount
SelectedColumnCount Number of selected columns. GetSelectedColumnCount
SelectedColumns Returns string of indexes delimited by separator or array of indexes of selected columns. GetSelectedColumns
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
SelectionCount Number of selected items. GetSelectionCount
Text Text of the currently focused cell. GetText

Action Summary

Action Description
DoAddSelection Extends selection.
DoClearSelection Clears selection.
DoClickItem Clicks the specified cell
DoFullText Read and return full text contents of the table
DoRemoveSelection Removes selection from specified items.
DoSelectItem Selects items of this object.

Property Detail

Cell

Text of the specified cell.

Type: string

Accessors: GetCell

value = SeS('SomeC1TrueDBListCombo').GetCell(/**Number*/row, /**Number*/col)

ColumnCount

Number of columns in the table.

Type: number

Accessors: GetColumnCount

value = SeS('SomeC1TrueDBListCombo').GetColumnCount()

ColumnName

Caption of a column.

Getter Parameters:

Name Type Description
col number Zero-based index of the column.

Type: string

Accessors: GetColumnName

value = SeS('SomeC1TrueDBListCombo').GetColumnName(/**number*/ col)

ItemCount

Number of items.

Type: number

Accessors: GetItemCount

value = SeS('SomeC1TrueDBListCombo').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

value = SeS('SomeC1TrueDBListCombo').GetItemIndexByName(name)

ItemNameByIndex

Returns item name by its index.'false' if name is not found.

Getter Parameters:

Name Type Description
index number Index of the item
column number Zero-based index of a column

Type: string|boolean

Accessors: GetItemNameByIndex

value = SeS('SomeC1TrueDBListCombo').GetItemNameByIndex(index, column)

RowCount

Number of rows in the table.

Type: number

Accessors: GetRowCount

value = SeS('SomeC1TrueDBListCombo').GetRowCount()

SelectedColumnCount

Number of selected columns.

Type: number

Accessors: GetSelectedColumnCount

value = SeS('SomeC1TrueDBListCombo').GetSelectedColumnCount()

SelectedColumns

Returns string of indexes delimited by separator or array of indexes of selected columns.

Getter Parameters:

Name Type Description
asArray boolean If set to true, function returns an array.
separator string Separator character. Possible values: ";", ",", "\", "/"
Optional, Default: ";".

Type: array|string

Accessors: GetSelectedColumns

value = SeS('SomeC1TrueDBListCombo').GetSelectedColumns(asArray, separator)

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

value = SeS('SomeC1TrueDBListCombo').GetSelectedIndices(asArray, separator)

SelectedItems

Text of all the selected items in a single string. Items are divided by ';' separator.

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: GetSelectedItems

value = SeS('SomeC1TrueDBListCombo').GetSelectedItems(asArray, separator)

SelectionCount

Number of selected items.

Type: number

Accessors: GetSelectionCount

value = SeS('SomeC1TrueDBListCombo').GetSelectionCount()

Text

Text of the currently focused cell.

Type: string

Accessors: GetText

value = SeS('SomeC1TrueDBListCombo').GetText()

Action Detail

DoAddSelection

Extends selection.

SeS('SomeC1TrueDBListCombo').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.

SeS('SomeC1TrueDBListCombo').DoClearSelection()

Returns:

boolean: 'true' if success, 'false' otherwise.

DoClickItem

Clicks the specified cell

SeS('SomeC1TrueDBListCombo').DoClickItem(row, col, clickType, xOffset, yOffset)

Parameters:

Name Type Description
row number Zero-based index if the row.
col number Zero-based index of the column.
clickType string Type of click, can be one of "L" - left click, "LD" - double left click, "R" - right click, "RD" - double right click, "M" - middle click, "MD" - double middle click, "N" - don't click Possible values: "L", "LD", "R", "RD", "M", "MD", "N"
Optional, Default: "L".
xOffset number X offset to click within object. Calculated from the top-left corner. Default is a center. Floating point in the range (-2, 2) means percentage of the width.
Optional.
yOffset number Y offset to click within object. Calculated from the top-left corner. Default is a center. Floating point in the range (-2, 2) means percentage of the height.
Optional.

Returns:

boolean: 'true' if successful, 'false' otherwise

DoFullText

Read and return full text contents of the table

SeS('SomeC1TrueDBListCombo').DoFullText()

Returns:

string |
boolean: Full text of the table (may be very long!), 'false' otherwise

DoRemoveSelection

Removes selection from specified items.

SeS('SomeC1TrueDBListCombo').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.

SeS('SomeC1TrueDBListCombo').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.

Behavior Pattern: C1TrueDBGridComboBehavior

Property Summary

Property Description Getter Setter
SelectedIndex Index of the selected element of the object. GetSelectedIndex SetSelectedIndex
SelectedItem Returns the selected item GetSelectedItem
Text Returns the text of the selected item GetText

Action Summary

Action Description
DoSelectItem Selects an item of this object.

Property Detail

SelectedIndex

Index of the selected element of the object.

Type: string

Accessors: GetSelectedIndex, SetSelectedIndex

value = SeS('SomeC1TrueDBListCombo').GetSelectedIndex()

SeS('SomeC1TrueDBListCombo').SetSelectedIndex()

SelectedItem

Returns the selected item

Type: string

Accessors: GetSelectedItem

value = SeS('SomeC1TrueDBListCombo').GetSelectedItem()

Text

Returns the text of the selected item

Type: string

Accessors: GetText

value = SeS('SomeC1TrueDBListCombo').GetText()

Action Detail

DoSelectItem

Selects an item of this object.

SeS('SomeC1TrueDBListCombo').DoSelectItem(item)

Parameters:

Name Type Description
item string | number Item index or text value to select.

Returns:

boolean: 'true' if success, 'false' otherwise.