ToolTipText Property (Cell)

Gets or sets the ToolTip text associated with the cell.

Syntax

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

<SRCategoryAttribute("Appearance")>
<SRDescriptionAttribute("Indicates the text of the Cell's ToolTip.")>
<DefaultValueAttribute()>
<LocalizableAttribute(True)>
Public Property ToolTipText As String

Dim instance As Cell
Dim value As String
 
instance.ToolTipText = value
 
value = instance.ToolTipText

[SRCategory("Appearance")]
[SRDescription("Indicates the text of the Cell's ToolTip.")]
[DefaultValue()]
[Localizable(true)]
public string ToolTipText {get; set;}

Property Value

A System.String value that represents the ToolTip text associated with the cell. The default is String.Empty.

Remarks

Changing this property raises the GcMultiRow.CellToolTipTextChanged event.

This property value is displayed as the cell ToolTip when the pointer is over the cell.

If this property value is String.Empty and the cell's value cannot display completely, the cell's ToolTip displays the content of the cell's value; if this property value is not String.Empty, this property value is displayed.

You can handle the GcMultiRow's GcMultiRow.CellToolTipTextNeeded event when the GcMultiRow.DataSource or GcMultiRow.VirtualMode property is set in the control. This is useful when working with large amounts of data to avoid performance penalties when setting the cell's ToolTipText value for multiple cells.

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

Cell Class
Cell Members
ShowCellToolTips Property
CellToolTipTextChanged Event
CellToolTipTextNeeded Event