MultiRow Windows Forms > Developer's Guide > Using MultiRow > Cell Types > RadioGroupCell |
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.
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.
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.
The radio group cell does not support the cell edit control. The RadioGroupCell.EditType property always returns a null reference (Nothing in Visual Basic).
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.
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. |
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: