The link label cell has features similar to the .NET Framework's LinkLabel control (System.Windows.Forms.LinkLabel). The user can use the link label cell to click a hyperlink and the developer can customize the behavior when the hyperlink is clicked.
Features
In addition to the Base Cell features, the following features can also be used in a link label cell.
- Display String with Link
- Distinguish visited links
For more details on each feature, refer to the LinkLabelCell class.
Data Types
The link label cell uses the value Object type and this type can be checked with the LinkLabelCell.ValueType property. The link string displayed on the link label uses a value cast into a String type. This type can be checked with the LinkLabelCell.FormattedValueType property. You can modify type cast behavior by overriding the Object type ToString method. Override the LinkLabelCell.OnCellFormatting method to change behavior when a value is read in a cell. Override the LinkLabelCell.OnCellParsing method to change behavior when a value is written back from a cell.
The link label cell does not provide a cell edit control. The LinkLabelCell.EditType property always returns a null reference (Nothing in Visual Basic).
Styles
The link label cell supports the following CellStyle class members. You can set the cell style with the LinkLabelCell.Style property.
| CellStyle Members | Enabled or Disabled |
| BackColor | Enabled |
| Border | Enabled |
| DataSourceNullValue | Enabled |
| DisabledBackColor | Enabled |
| DisabledForeColor | Enabled |
| Font | Enabled |
| ForeColor | - |
| Format | Enabled |
| FormatProvider | Enabled |
| GradientColors | Enabled |
| GradientDirection | Enabled |
| GradientStyle | Enabled |
| Image | Enabled |
| ImageAlign | Enabled |
| ImeMode | - |
| ImeSentenceMode | - |
| InputScope | - |
| LineAdjustment | Enabled only for GDI+ Compatible Mode |
| Margin | Enabled |
| Multiline | Enabled |
| NullValue | Enabled |
| Padding | Enabled |
| PatternColor | Enabled |
| PatternStyle | Enabled |
| SelectionBackColor | Enabled |
| SelectionForeColor | - |
| Tag | Enabled |
| TextAdjustment | Enabled only for GDI+ Compatible Mode |
| TextAlign | Enabled |
| TextAngle | Enabled only for GDI +Compatible Mode |
| TextEffect | Enabled |
| TextImageRelation | Enabled |
| TextIndent | Enabled |
| TextVertical | Enabled only for GDI+ Compatible Mode |
| UseCompatibleTextRendering | Enabled |
| WordWrap | Enabled |
To enable GDI+ Compatibility Mode, set the UseCompatibleTextRendering property to True.
Shortcut Keys
In the link label cell, Keys.Space is allocated for clicking on the link. Keys other than this are processed by the GcMultiRow control.
Events
You can use the GcMultiRow.CellContentClick event to get a click in the cell content area. You can use the GcMultiRow.CellContentDoubleClick event for a double-click.
See the following topics for more information: