TreeList.FocusedColumn Property

Gets or sets the focused column.

Namespace: DevExpress.XtraTreeList

Assembly: DevExpress.XtraTreeList.v18.2.dll

Declaration

C#

[Browsable(false)]
public TreeListColumn FocusedColumn { get; set; }

VB.NET

<Browsable(False)>
Public Property FocusedColumn As TreeListColumn

Property Value

Type	Description
TreeListColumn	The focused column.

Remarks

Read the FocusedColumn property to obtain the object representing the focused column. Assign a TreeListColumn object to this property to focus the corresponding column.

Note

Assigning to the FocusedColumn property is not in effect if the assigned column is either invisible (its TreeListColumn.VisibleIndex property’s value is -1).

When a column is assigned to the FocusedColumn property, the control automatically scrolls to this column. To scroll the control to the required column without focusing it, use the TreeList.MakeColumnVisible method.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the FocusedColumn property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

how-to-add-a-horizontal-cells-merge-capability-to-an-xtratreelist-control-e2501/CS/TreeListCellMerging/MyTreeList.cs#L32

{
    this.FocusedColumn = this.GetColumnByVisibleIndex(FocusedColumn.VisibleIndex + step);
}

how-to-print-a-treelist-that-supports-the-horizontal-cell-merging-capability-e4344/CS/TreeListCellMerging/MyTreeList.cs#L33

{
    this.FocusedColumn = this.GetColumnByVisibleIndex(FocusedColumn.VisibleIndex + step);
}

how-to-show-error-icons-for-cells-when-the-treelist-operates-in-unbound-mode-e1932/CS/Form1.cs#L60

{
    string error = GetError(treeList1.FocusedNode.GetValue(treeList1.FocusedColumn), treeList1.FocusedColumn, treeList1.FocusedNode);
    if (error == string.Empty) return;

how-to-display-custom-text-next-to-a-check-box-within-the-same-cell-e888/CS/WindowsApplication6/Form1.cs#L46

DevExpress.XtraTreeList.TreeList tl = sender as DevExpress.XtraTreeList.TreeList;
if (tl.FocusedColumn != tl.Columns["IMAGEINDEX"])
    return;

how-to-implement-block-selection-for-treelist-cells-e2176/CS/BlockSelection/BlockSelector.cs#L83

private void fList_FocusedNodeChanged(object sender, FocusedNodeChangedEventArgs e) { if (fList.FocusedColumn != null) UpdateBlock(); }

VB.NET

how-to-add-a-horizontal-cells-merge-capability-to-an-xtratreelist-control-e2501/VB/TreeListCellMerging/MyTreeList.vb#L29

If Equals(Me.FocusedNode.GetValue(e.Column), Me.FocusedNode.GetValue(nextColumn)) Then
    Me.FocusedColumn = Me.GetColumnByVisibleIndex(FocusedColumn.VisibleIndex + [step])
End If

how-to-print-a-treelist-that-supports-the-horizontal-cell-merging-capability-e4344/VB/TreeListCellMerging/MyTreeList.vb#L30

If Equals(Me.FocusedNode.GetValue(e.Column), Me.FocusedNode.GetValue(nextColumn)) Then
    Me.FocusedColumn = Me.GetColumnByVisibleIndex(FocusedColumn.VisibleIndex + [step])
End If

how-to-show-error-icons-for-cells-when-the-treelist-operates-in-unbound-mode-e1932/VB/Form1.vb#L65

Private Sub treeList1_ShowingEditor(ByVal sender As Object, ByVal e As CancelEventArgs) Handles treeList1.ShowingEditor
        Dim [error] As String = GetError(treeList1.FocusedNode.GetValue(treeList1.FocusedColumn), treeList1.FocusedColumn, treeList1.FocusedNode)
        If [error] = String.Empty Then

how-to-display-custom-text-next-to-a-check-box-within-the-same-cell-e888/VB/WindowsApplication6/Form1.vb#L42

Dim tl As DevExpress.XtraTreeList.TreeList = TryCast(sender, DevExpress.XtraTreeList.TreeList)
If tl.FocusedColumn IsNot tl.Columns("IMAGEINDEX") Then
    Return

how-to-implement-block-selection-for-treelist-cells-e2176/VB/BlockSelection/BlockSelector.vb#L90

Private Sub fList_FocusedNodeChanged(ByVal sender As Object, ByVal e As FocusedNodeChangedEventArgs)
    If fList.FocusedColumn IsNot Nothing Then
        UpdateBlock()