ShowCellToolTips Property

Gets or sets a value that indicates whether tooltips are shown when the mouse pointer pauses on a cell.

Syntax

Visual Basic (Declaration)
Visual Basic (Usage)
C#

<SRDescriptionAttribute("Indicates whether ToolTips show when the mouse pointer pauses on a cell.")>
<DefaultValueAttribute()>
<SRCategoryAttribute("Appearance")>
Public Property ShowCellToolTips As Boolean

Dim instance As GcMultiRow
Dim value As Boolean
 
instance.ShowCellToolTips = value
 
value = instance.ShowCellToolTips

[SRDescription("Indicates whether ToolTips show when the mouse pointer pauses on a cell.")]
[DefaultValue()]
[SRCategory("Appearance")]
public bool ShowCellToolTips {get; set;}

Property Value

true if cell tooltips are enabled; otherwise, false. The default is true.

Remarks

When the value of this property is true and the mouse pointer is over a cell, the cell displays a tooltip when one of the following conditions is met:

The value of the DataSource property is not a null reference (Nothing in Visual Basic) or the value of the VirtualMode property is true, and a handler for the CellToolTipTextNeeded event sets the CellToolTipTextNeededEventArgs.ToolTipText property to a value other than String.Empty.
The ToolTipText property of the cell has a value other than String.Empty. Setting this property has no effect when there is a CellToolTipTextNeeded event handler because getting the value of the property automatically raises the event and returns the ToolTip text specified in the event handler.
The cell value is truncated in the cell display. When the value of the cell ToolTipText property value is String.Empty, the full value of the truncated cell value is displayed in the tooltip.

Example

This example creates a cell tooltip.

GrapeCity.Win.MultiRow.TextBoxCell text1 = new GrapeCity.Win.MultiRow.TextBoxCell();
GrapeCity.Win.MultiRow.TextBoxCell text2 = new GrapeCity.Win.MultiRow.TextBoxCell();
text1.Name = "text1";
text2.Name = "text2";
GrapeCity.Win.MultiRow.Template template1 = GrapeCity.Win.MultiRow.Template.CreateGridTemplate(new GrapeCity.Win.MultiRow.Cell[] { text1, text2 }, 160, GrapeCity.Win.MultiRow.AutoGenerateGridTemplateStyles.ColumnHeader | GrapeCity.Win.MultiRow.AutoGenerateGridTemplateStyles.RowHeaderAutoNumber);
template1.ColumnHeaders[0].Cells[0].Value = "Column1";
template1.ColumnHeaders[0].Cells[1].Value = "Column2";
gcMultiRow1.Template = template1;
gcMultiRow1.RowCount = 3;
gcMultiRow1.ShowCellToolTips = true;
gcMultiRow1.CellToolTipAutomaticDelay = 150;
gcMultiRow1.CellToolTipInitialDelay = 30;
gcMultiRow1[1, 0].ToolTipText = "Cell Text";

VB.NET

Dim text1 As New GrapeCity.Win.MultiRow.TextBoxCell()
Dim text2 As New GrapeCity.Win.MultiRow.TextBoxCell()
text1.Name = "text1"
text2.Name = "text2"
Dim template1 As GrapeCity.Win.MultiRow.Template = GrapeCity.Win.MultiRow.Template.CreateGridTemplate(New GrapeCity.Win.MultiRow.Cell() {text1, text2}, 160, GrapeCity.Win.MultiRow.AutoGenerateGridTemplateStyles.ColumnHeader Or GrapeCity.Win.MultiRow.AutoGenerateGridTemplateStyles.RowHeaderAutoNumber)
template1.ColumnHeaders(0).Cells(0).Value = "Column1"
template1.ColumnHeaders(0).Cells(1).Value = "Column2"
GcMultiRow1.Template = template1
GcMultiRow1.RowCount = 3
GcMultiRow1.ShowCellToolTips = True
GcMultiRow1.CellToolTipAutomaticDelay = 150
GcMultiRow1.CellToolTipInitialDelay = 30
GcMultiRow1(1, 0).ToolTipText = "Cell Text"

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

GcMultiRow Class
GcMultiRow Members
Cell.ToolTipText