The radio group cell has features similar to the .NET Framework's RadioButton control (System.Windows.Forms.RadioButton). The user can select a value with the radio button in the radio group cell.
Features
In addition to the Base Cell features, the radio group cell lets users select a value from multiple items. For more details on this feature, refer to the RadioGroupCell class.
Data Types
The radio group cell uses the Object type value. This type can be checked with the RadioGroupCell.ValueType property. The value cast into the Integer type (int type in C#) is used for input and display. This type can be checked with the RadioGroupCell.FormattedValueType property. You can override the RadioGroupCell.OnCellFormatting method to modify the behavior when values are read in a cell. Override the RadioGroupCell.OnCellParsing method to modify behavior when the value is written back from the cell.
Cell Edit Control
The radio group cell does not support the cell edit control. The RadioGroupCell.EditType property always returns a null reference (Nothing in Visual Basic).
Styles
The radio group cell supports the following CellStyle members. You can set the cell style using the RadioGroupCell.Style property.
| CellStyle Members | Enabled or Disabled |
|---|---|
| BackColor | Enabled |
| BackgroundGradientEffect | Enabled |
| Border | Enabled |
| DataSourceNullValue | Enabled |
| DisabledBackColor | Enabled |
| DisabledForeColor | Enabled |
| DisabledGradientEffect | Enabled |
| EditingBackColor | - |
| EditingForeColor | - |
| Font | Enabled |
| ForeColor | Enabled |
| Format | Enabled |
| FormatProvider | Enabled |
| Image | - |
| ImageAlign | - |
| ImeMode | - |
| ImeSentenceMode | - |
| InputScope | - |
| LineAdjustment | Enabled only for GDI+ Compatible Mode |
| Margin | Enabled |
| MouseOverBackColor | Enabled |
| MouseOverForeColor | Enabled |
| MouseOverGradientEffect | Enabled |
| Multiline | Enabled |
| NullValue | Enabled |
| Padding | Enabled |
| PatternColor | Enabled |
| PatternStyle | Enabled |
| SelectionBackColor | Enabled |
| SelectionForeColor | Enabled |
| SelectionGradientEffect | Enabled |
| Tag | Enabled |
| TextAdjustment | Enabled only for GDI+ Compatible Mode |
| TextAlign | Enabled |
| TextAngle | Enabled only for GDI+ Compatible Mode |
| TextEffect | Enabled |
| TextImageRelation | - |
| TextIndent | Enabled |
| TextVertical | Enabled only for GDI+ Compatible Mode |
| UseCompatibleTextRendering | Enabled |
| WordWrap | Enabled |
To set GDI+ Compatibility Mode as Enabled, set the RadioGroupCell.Style.UseCompatibleTextRendering property to True.
Shortcut Keys
The following table lists the keys that are processed when the radio group cell is in edit mode and lists keys that are processed by the GcMultiRow control.
| Modifier | Key | RadioGroupCell | GcMultiRow |
|---|---|---|---|
| None | Keys.PageUp | - | Enabled |
| Keys.PageDown | - | Enabled | |
| Keys.End | - | Enabled | |
| Keys.Home | - | Enabled | |
| Keys.Left | Enabled | - | |
| Keys.Right | Enabled | - | |
| Keys.Up | Enabled | - | |
| Keys.Down | Enabled | - | |
| Keys.Insert | - | - | |
| Keys.Delete | Enabled | - | |
| Keys.BackSpace | Enabled | - | |
| Keys.Control | Keys.PageUp | - | - |
| Keys.PageDown | - | - | |
| Keys.End | - | Enabled | |
| Keys.Home | - | Enabled | |
| Keys.Left | - | Enabled | |
| Keys.Right | - | Enabled | |
| Keys.Up | - | Enabled | |
| Keys.Down | - | Enabled | |
| Keys.A | - | Enabled | |
| Keys.C | Enabled | - | |
| Keys.V | - | Enabled | |
| Keys.X | - | Enabled | |
| Keys.Shift | Keys.Left | - | Enabled |
| Keys.Right | - | Enabled | |
| Keys.Up | - | Enabled | |
| Keys.Down | - | Enabled | |
| Keys.Home | - | Enabled | |
| Keys.End | - | Enabled | |
| None | Keys.Space | Enabled | - |
 |
Keys.Control + Keys.C is processed by the GcMultiRow control when multiple cells are selected. |
Events
You can use the GcMultiRow.CellContentClick event to implement the processing for a click in the cell content area. Use the GcMultiRow.CellContentDoubleClick event for a double-click. The GcMultiRow.CellEditedFormattedValueChanged event is fired when the cell value changes.
See the following topic for more information: