The label cell has features similar to the .NET Framework's Label control (System.Windows.Forms.Label). The user can use this label cell to display non-editable text.
Features
In addition to the Base Cell features, the following features can also be used in the label cell.
- Display a Caption
- Display an Image
For more details on each feature, refer to the LabelCell class.
Data Types
The label cell uses the Object value type and this type can be checked with the LabelCell.ValueType property. The caption shown on the label uses a value that has been type cast to a String type. This type can be checked with the LabelCell.FormattedValueType property. You can modify type cast behavior by overriding the Object type ToString method. Override the LabelCell.OnCellFormatting method to change behavior when a value is read in a cell. Override the LabelCell.OnCellParsing method to change behavior when a value is written back from the cell.
Cell Edit Control
The label cell does not provide a cell edit control. The LabelCell.EditType property always returns a null reference (Nothing in Visual Basic).
Styles
The label cell supports the following CellStyle class members. You can set the cell style with the LabelCell.Style property.
| CellStyle Members | Enabled or Disabled |
| BackColor | Enabled |
| Border | Enabled |
| DataSourceNullValue | Enabled |
| DisabledBackColor | Enabled |
| DisabledForeColor | Enabled |
| Font | Enabled |
| ForeColor | Enabled |
| 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 | Enabled |
| 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
No shortcut keys are handled in a label cell.
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.
For more information see the following topics: