TcxCustomTreeList.FocusedColumn Property

Specifies the focused column.

Declaration

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

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

Delphi

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

C++

void TMyForm::SetFocusedCellValue(Variant AValue){
  cxTreeList->FocusedNode->Values[cxTreeList->FocusedColumn->ItemIndex] = AValue;
}

Limitations

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

• The Tree List control’s OptionsSelection.CellSelect property is set to True.
• The column’s Options.Focusing property is set to True.