Obtaining and Setting Cell Values
- 3 minutes to read
The Tree List control displays data by means of nodes that contain cells for each column. Each cell’s data can be obtained and changed. See below, for information on how to get and set cell values.
To get and set cell values in code, use the methods provided by the TreeList and TreeListNode classes:
|TreeList.SetRowCellValue||Sets the TreeList cell to a specific value.|
|TreeListNode.Item||Gets or sets the edit value of a specific cell.|
|TreeListNode.GetValue||Returns the edit value of a specific cell.|
|TreeListNode.GetDisplayText||Returns the display value of a specific cell. Display values are text representations of edit values, formatted in a specific manner.|
|TreeListNode.SetValue||Changes the edit value of a specific cell.|
There are multiple ways to obtain a node object before getting/changing its cells. Please refer to Member Table: Nodes, to find out which common methods can be used to obtain references to nodes.
The methods listed in the table above require a column identifier as a parameter. The following section describes column identifiers supported by the methods.
Several objects can be used as column identifiers. These are:
The TreeListColumn object representing the desired column.
The following code may be used to obtain a TreeListColumn object by its field name. We will assume that there is a column bound to the “Budget” field. The TreeList.Columns property of the Tree List control is used to access the column.
The TreeListColumn.FieldName property value of the desired column.
The field name is a string that binds the column to a data source field. When a Tree List is populated from the System.Data.DataTable object, for example, the TreeListColumn.FieldName is automatically initialized with the name of a field from the data source.
The TreeListColumn.AbsoluteIndex property value of the desired column.
The absolute index is the position of the column within the column collection. The following code demonstrates how to get this value for the “Budget” column.
The System.Data.DataColumn object corresponding to the desired column (if the TreeList.DataSource is represented by a System.Data.DataView or System.Data.DataTable source).