Gets or sets whether the grid displays a pop-up text window when the cursor is idle.

Remarks

By default, this property is set to CellTipEnum.NoCellTips, and cell tips are not displayed.

If the CellTips property is set to either CellTipEnum.Anchored or CellTipEnum.Floating, the FetchCellTips event will be raised whenever the grid has focus and the cursor is idle over a grid cell, record selector, column header, split header, or grid caption. The event will not fire if the cursor is over the scroll bars.

The setting CellTipEnum.Anchored aligns the cell tip window with either the left or right edge of the cell. The left edge is favored, but the right edge will be used if necessary in order to display as much text as possible.

The setting CellTipEnum.Floating displays the cell tip window below the cursor, if possible.

If a handler is not provided for the FetchCellTips event, and the cursor is over a grid cell, the default behavior is to display a text box containing the cell's contents (up to 256 characters). This enables the user to peruse the contents of a cell even if it is not big enough to be displayed in its entirety. The FetchCellTips event can be programmed to override the default cell text display in order to provide users with context-sensitive help.

Use the CellTipsDelay property to control the amount of idle time that must elapse before the cell tip window is displayed.

Use the CellTipsWidth property to control the width of the cell tip window.

Example

The following code uses the CellTips property to display the cell tip window below the cursor:

·      Visual Basic

·      C#

·      Delphi

For an example demonstrating the CellTips property, see the Context-Sensitive Help with CellTips topic.

See Also

C1TrueDBGrid Class | C1TrueDBGrid Members | C1.Win.C1TrueDBGrid Namespace

Send comments about this topic to ComponentOne. Copyright © ComponentOne LLC. All rights reserved.