TcxCustomGridTableController.FocusedItem Property

Specifies the focused data item in the current record.

Declaration

property FocusedItem: TcxCustomGridTableItem read; write;

Property Value

Type	Description
TcxCustomGridTableItem	The focused data item. If the property value is nil (in Delphi) or nullptr (in C++Builder).

Remarks

Use the FocusedItem property to focus a specific data item in the active record.

You can use the item’s Options.Focusing and View’s OptionsSelection.CellSelect property to prevent focusing any View items.

The FocusedItemIndex property allows you to access/specify the focused item by its visual index (the position within the View’s VisibleItems collection).

Every time focus moves to another item, the View’s OnFocusedItemChanged event occurs.

The following code sets focus to tvOrdersProductID item of the tvOrders View:

Delphi

tvOrders.Controller.FocusedItem := tvOrdersProductID;

C++

tvOrders->Controller->FocusedItem = tvOrdersProductID;