
ラジオグループ型セル(RadioGroupCell)は、.NET Frameworkの複数のRadioButtonコントロール(System.Windows.Forms.RadioButton)と同等の機能を提供します。RadioGroupCellを使用すると、ユーザーはラジオボタンを使用して任意の値を選択できます。
機能
データ型
RadioGroupCellはObject型の値を保持します。この型はRadioGroupCell.ValueTypeプロパティで確認できます。
入力と表示には、Integer型(C#ではint型)にキャストした値が使用されます。この型はRadioGroupCell.FormattedValueTypeプロパティで確認できます。セルに値が読み出される場合の動作を変更するには、RadioGroupCell.OnCellFormattingメソッドをオーバーライドします。セルから値が書き戻される場合の動作を変更するには、RadioGroupCell.OnCellParsingメソッドをオーバーライドします。
入力と表示には、Integer型(C#ではint型)にキャストした値が使用されます。この型はRadioGroupCell.FormattedValueTypeプロパティで確認できます。セルに値が読み出される場合の動作を変更するには、RadioGroupCell.OnCellFormattingメソッドをオーバーライドします。セルから値が書き戻される場合の動作を変更するには、RadioGroupCell.OnCellParsingメソッドをオーバーライドします。
セル編集コントロール
RadioGroupCellのセル編集コントロールはありません。RadioGroupCell.EditTypeプロパティは常にnull参照(Visual BasicではNothing)を返します。
スタイル
RadioGroupCellはCellStyleクラスの次のメンバをサポートしています。セルのスタイルはRadioGroupCell.Styleプロパティで設定します。
GDI+互換モードを有効にするには、RadioGroupCell.Style.UseCompatibleTextRenderingプロパティをTrueに設定します。
| CellStyleメンバ | 有効/無効 |
|---|---|
| BackColor | 有効 |
| BackgroundGradientEffect | 有効 |
| Border | 有効 |
| DataSourceNullValue | 有効 |
| DisabledBackColor | 有効 |
| DisabledForeColor | 有効 |
| DisabledGradientEffect | 有効 |
| EditingBackColor | - |
| EditingForeColor | - |
| Font | 有効 |
| ForeColor | 有効 |
| Format | 有効 |
| FormatProvider | 有効 |
| Image | - |
| ImageAlign | - |
| ImeMode | - |
| ImeSentenceMode | - |
| InputScope | - |
| LineAdjustment | GDI+互換モードの場合のみ有効 |
| Margin | 有効 |
| MouseOverBackColor | 有効 |
| MouseOverForeColor | 有効 |
| MouseOverGradientEffect | 有効 |
| Multiline | 有効 |
| NullValue | 有効 |
| Padding | 有効 |
| PatternColor | 有効 |
| PatternStyle | 有効 |
| SelectionBackColor | 有効 |
| SelectionForeColor | 有効 |
| SelectionGradientEffect | 有効 |
| Tag | 有効 |
| TextAdjustment | GDI+互換モードの場合のみ有効 |
| TextAlign | 有効 |
| TextAngle | GDI+互換モードの場合のみ有効 |
| TextEffect | 有効 |
| TextImageRelation | - |
| TextIndent | 有効 |
| TextVertical | GDI+互換モードの場合のみ有効 |
| UseCompatibleTextRendering | 有効 |
| WordWrap | 有効 |
GDI+互換モードを有効にするには、RadioGroupCell.Style.UseCompatibleTextRenderingプロパティをTrueに設定します。
ショートカットキー
次の表はRadioGroupCellの編集時に処理されるキーとGcMultiRowコントロールで処理されるキーの一覧です。
Keys.Control+Keys.Cは複数のセルが選択されている場合はGcMultiRowコントロールによって処理されます。
| 修飾子 | キー | ラジオグループ型セル | GcMultiRow |
|---|---|---|---|
| なし | Keys.PageUp | - | 有効 |
| Keys.PageDown | - | 有効 | |
| Keys.End | - | 有効 | |
| Keys.Home | - | 有効 | |
| Keys.Left | 有効 | - | |
| Keys.Right | 有効 | - | |
| Keys.Up | 有効 | - | |
| Keys.Down | 有効 | - | |
| Keys.Insert | - | - | |
| Keys.Delete | 有効 | - | |
| Keys.BackSpace | 有効 | - | |
| Keys.Control | Keys.PageUp | - | - |
| Keys.PageDown | - | - | |
| Keys.End | - | 有効 | |
| Keys.Home | - | 有効 | |
| Keys.Left | - | 有効 | |
| Keys.Right | - | 有効 | |
| Keys.Up | - | 有効 | |
| Keys.Down | - | 有効 | |
| Keys.A | - | 有効 | |
| Keys.C | 有効 | - | |
| Keys.V | - | 有効 | |
| Keys.X | - | 有効 | |
| Keys.Shift | Keys.Left | - | 有効 |
| Keys.Right | - | 有効 | |
| Keys.Up | - | 有効 | |
| Keys.Down | - | 有効 | |
| Keys.Home | - | 有効 | |
| Keys.End | - | 有効 | |
| なし | Keys.Space | 有効 | - |
Keys.Control+Keys.Cは複数のセルが選択されている場合はGcMultiRowコントロールによって処理されます。
イベント
セルの内容領域のクリックに対応した処理を実装するには、GcMultiRow.CellContentClickイベントを使用します。ダブルクリックの場合はGcMultiRow.CellContentDoubleClickイベントです。
セルの値が編集されたときにはGcMultiRow.CellEditedFormattedValueChangedイベントが発生します。
セルの値が編集されたときにはGcMultiRow.CellEditedFormattedValueChangedイベントが発生します。
使用例