Skip to main content

TcxCustomGridTableController.FocusedItem Property

Specifies the item of the current record being focused.

Declaration

property FocusedItem: TcxCustomGridTableItem read; write;

Property Value

Type
TcxCustomGridTableItem

Remarks

Use the FocusedItem property to focus a specific item (column in a (Banded) Table View and row in a Card View) within the active record.

You can use the item’s Options.Focusing and View’s OptionsSelection.CellSelect property to prevent focusing any View items. If no item is focused at the moment, FocusedItem returns nil. To test whether a specific item is focused, see its Focused property.

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 set to another item, the View’s OnFocusedItemChanged event is generated.

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

tvOrders.Controller.FocusedItem := tvOrdersProductID;
See Also