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