Skip to content

DXTreeList

DevXpress TreeList.

UI element class: DevExpress.XtraTreeList.TreeList

Extends ManagedObject

Extends SeSSimulatedObject

Behavior Pattern: DXTreeListBehavior

Property Summary

Property Description Getter Setter
CellText Cell text for the cell specified by 'rowPath' and 'col'. GetCellText
Checked Checked state of the selected node or a node specified by the input parameters. GetChecked
ChildrenCount Number of children of the selected node or a node specified by the input parameters. GetChildrenCount
ColumnCount Number of columns in current grid. GetColumnCount
ColumnName Caption of a column. GetColumnName
Expanded Expanded state of the selected node or a node specified by the input parameters. GetExpanded
IndexPath Index path of the specified or selected tree node i.e. GetIndexPath
NodeText Text of the selected node or a node specified by the input parameters. GetNodeText
RowCount Number of rows in current grid. GetRowCount
Selected Selected state of the selected node or a node specified by the input parameters GetSelected
Text ;-combined text of all selected nodes. GetText

Action Summary

Action Description
DoClickCell Click the cell specified by row name or index and column name or index
DoClickNode Clicks specific node in the tree.
DoCollapse Collapses specific node in the tree.
DoExpand Expands specific node in the tree.
DoSetCheck Set 'checked' state of the specified node

Property Detail

CellText

Cell text for the cell specified by 'rowPath' and 'col'.

Getter Parameters:

Name Type Description
rowPath string | number Path of the top level node to select. If integer number is passed then the top level node is searched by index.
col number | string Column index or column name. Default is 0
Optional.

Type: string

Accessors: GetCellText

value = SeS('SomeDXTreeList').GetCellText(/**string|number*/ rowPath, /**number|string*/ col)

Checked

Checked state of the selected node or a node specified by the input parameters.

Getter Parameters:

Name Type Description
path string Path of the node
separator string Separator character. Possible values: ";", ",", "\", "/"
Optional, Default: ";".
pathType string Path type. Can be one of 'name', 'id' or 'index'. Possible values: "name", "index", "id"
Optional, Default: "name".

Type: boolean

Accessors: GetChecked

value = SeS('SomeDXTreeList').GetChecked(path, separator, pathType)

ChildrenCount

Number of children of the selected node or a node specified by the input parameters.

Getter Parameters:

Name Type Description
path string Path of the node
separator string Separator character. Possible values: ";", ",", "\", "/"
Optional, Default: ";".
pathType string Path type. Can be one of 'name', 'id' or 'index'. Possible values: "name", "index", "id"
Optional, Default: "name".

Type: string|boolean

Accessors: GetChildrenCount

value = SeS('SomeDXTreeList').GetChildrenCount(path, separator, pathType)

ColumnCount

Number of columns in current grid.

Type: number

Accessors: GetColumnCount

value = SeS('SomeDXTreeList').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('SomeDXTreeList').GetColumnName(/**number*/ col)

Expanded

Expanded state of the selected node or a node specified by the input parameters.

Getter Parameters:

Name Type Description
path string Path of the node
separator string Separator character. Possible values: ";", ",", "\", "/"
Optional, Default: ";".
pathType string Path type. Can be one of 'name', 'id' or 'index'. Possible values: "name", "index", "id"
Optional, Default: "name".

Type: boolean

Accessors: GetExpanded

value = SeS('SomeDXTreeList').GetExpanded(path, separator, pathType)

IndexPath

Index path of the specified or selected tree node i.e. string in form '0;5;2;1;6', 'false' if fails

Getter Parameters:

Name Type Description
path string Path of the node
separator string Separator character. Possible values: ";", ",", "\", "/"
Optional, Default: ";".
pathType string Path type. Can be one of 'name', 'id' or 'index'. Possible values: "name", "index", "id"
Optional, Default: "name".

Type: string|boolean

Accessors: GetIndexPath

value = SeS('SomeDXTreeList').GetIndexPath(path, separator, pathType)

NodeText

Text of the selected node or a node specified by the input parameters.

Getter Parameters:

Name Type Description
path string Path of the node
separator string Separator character. Possible values: ";", ",", "\", "/"
Optional, Default: ";".
pathType string Path type. Can be one of 'name', 'id' or 'index'. Possible values: "name", "index", "id"
Optional, Default: "name".

Type: string|boolean

Accessors: GetNodeText

value = SeS('SomeDXTreeList').GetNodeText(path, separator, pathType)

RowCount

Number of rows in current grid.

Type: number

Accessors: GetRowCount

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

Selected

Selected state of the selected node or a node specified by the input parameters

Getter Parameters:

Name Type Description
path string Path of the node
separator string Separator character. Possible values: ";", ",", "\", "/"
Optional, Default: ";".
pathType string Path type. Can be one of 'name', 'id' or 'index'. Possible values: "name", "index", "id"
Optional, Default: "name".

Type: boolean

Accessors: GetSelected

value = SeS('SomeDXTreeList').GetSelected(path, separator, pathType)

Text

;-combined text of all selected nodes.

Type: string

Accessors: GetText

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

Action Detail

DoClickCell

Click the cell specified by row name or index and column name or index

SeS('SomeDXTreeList').DoClickCell(rowPath, col, xOffset, yOffset)

Parameters:

Name Type Description
rowPath string | number Path of the top level node to select. If integer number is passed then the top level node is searched by index.
col number | string Column index or column name
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 success, 'false' otherwise.

DoClickNode

Clicks specific node in the tree.

SeS('SomeDXTreeList').DoClickNode(path, separator, pathType, column, xOffset, yOffset)

Parameters:

Name Type Description
path string Path of the node
separator string Separator character. Possible values: ";", ",", "\", "/"
Optional, Default: ";".
pathType string Path type. Can be one of 'name', 'id' or 'index'. Possible values: "name", "index", "id"
Optional, Default: "name".
column number | string Column index or column name. Default is 0
Optional.
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 success, 'false' otherwise.

DoCollapse

Collapses specific node in the tree.

SeS('SomeDXTreeList').DoCollapse(path, separator, pathType)

Parameters:

Name Type Description
path string Path of the node
separator string Separator character. Possible values: ";", ",", "\", "/"
Optional, Default: ";".
pathType string Path type. Can be one of 'name', 'id' or 'index'. Possible values: "name", "index", "id"
Optional, Default: "name".

Returns:

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

DoExpand

Expands specific node in the tree.

SeS('SomeDXTreeList').DoExpand(path, separator, pathType)

Parameters:

Name Type Description
path string Path of the node
separator string Separator character. Possible values: ";", ",", "\", "/"
Optional, Default: ";".
pathType string Path type. Can be one of 'name', 'id' or 'index'. Possible values: "name", "index", "id"
Optional, Default: "name".

Returns:

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

DoSetCheck

Set 'checked' state of the specified node

SeS('SomeDXTreeList').DoSetCheck(bcheck, path, separator, pathType)

Parameters:

Name Type Description
bcheck boolean Check state to set
path string Path of the node
separator string Separator character. Possible values: ";", ",", "\", "/"
Optional, Default: ";".
pathType string Path type. Can be one of 'name', 'id' or 'index'. Possible values: "name", "index", "id"
Optional, Default: "name".

Returns:

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