Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

TcxCustomTreeList.FocusedColumn Property

Specifies the focused column.

#Declaration

Delphi
property FocusedColumn: TcxTreeListColumn read; write;

#Property Value

Type Description
TcxTreeListColumn

The focused tree list column. The property returns nil (in Delphi) or nullptr (in C++Builder) if the Tree List control is empty or no column has focus.

The returned object can be a TcxTreeListColumn or TcxDBTreeListColumn class instance depending on the actual tree list column type. In the latter case, you need to cast the returned object to the TcxDBTreeListColumn class to access all available public API members.

Tip

To identify the actual tree list column type, call the returned object’s ClassName function.

#Remarks

You can use the FocusedColumn property to identify the focused column or to move focus between tree list columns.

#Code Example: Override SetFocusedCellValue Procedure Implementation

The following SetFocusedCellValue procedure implementation changes the focused cell’s value:

procedure TMyForm.SetFocusedCellValue(AValue: Variant);
begin
  cxTreeList.FocusedNode.Values[cxTreeList.FocusedColumn.ItemIndex] := AValue;
end;

#Limitations

You can focus a column only if the following conditions are met:

See Also