TcxCustomGridTableOptionsBehavior.PullFocusing Property

Indicates whether focus moves to the record under the mouse pointer when a user clicks the left mouse button within a View and starts moving the mouse while holding the button down.

Declaration

property PullFocusing: Boolean read; write; default False;

Property Value

Type	Default
Boolean	False

Remarks

Set the PullFocusing property to True to make the focused record track the mouse pointer when the end-user clicks the left mouse button within a View and starts moving the mouse while holding the button down. This allows you to scroll View records and move focus while dragging the mouse pointer within the View. This behavior is similar to that provided by the list box as this also allows you to select items by dragging. Furthermore, focused records then become selected and remain so, if the View’s OptionsSelection.MultiSelect property is set to True. When the OptionsSelection.CellMultiSelect property is set to True, clicking and moving the mouse also selects cells.

If PullFocusing is False, a click within the View focuses the underlying record. However, subsequent dragging has no effect.

The PullFocusing property affects focus movement only if a click within a View does not initiate drag-and-drop. This is the case if the View’s DragMode property is set to dmManual and you do not initiate drag-and-drop yourself by handling mouse-down events.

The default PullFosucing property value is False.