The ListBoxCell has features similar to the .NET Framework's ListBox control (System.Windows.Forms.ListBox). The user can use this ListBoxCell to display a list of items in the cell.
Features
In addition to the Base Cell features, the ListBoxCell provides a list display.
For more details on list box cells, refer to the ListBoxCell class.
Data Type
The ListBoxCell retains the Object value type. This type can be checked using the ListBoxCell.ValueType property.
For display, a value that has been type cast to a String type is used. This type can be checked with the ListBoxCell.FormattedValueType property.
You can modify type cast behavior by overriding the Object type of the ToString method. Override the ListBoxCell.OnCellFormatting method to change behavior when a value is read in a cell. Override the ListBoxCell.OnCellParsing method to change behavior when a value is written back from the cell.
Cell Editing Control
The ListBoxCell does not provide a cell edit control. The ListBoxCell.EditType property always returns a null reference (Nothing in case of Visual Basic).
Style
The ListBoxCell supports the following CellStyle class members. You can set the cell style with the ListBoxCell.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 | - |
| FormatProvider | - |
| Image | - |
| ImageAlign | - |
| ImeMode | Enabled |
| ImeSentenceMode | Enabled |
| InputScope | Enabled |
| LineAdjustment | - |
| Margin | Enabled |
| MouseOverBackColor | Enabled |
| MouseOverForeColor | Enabled |
| MouseOverGradientEffect | Enabled |
| Multiline | - |
| NullValue | Enabled |
| Padding | Enabled |
| PatternColor | Enabled |
| PatternStyle | Enabled |
| SelectionBackColor | Enabled |
| SelectionForeColor | Enabled |
| SelectionGradientEffect | Enabled |
| Tag | Enabled |
| TextAdjustment | - |
| TextAlign | - |
| TextAngle | - |
| TextEffect | - |
| TextImageRelation | - |
| TextIndent | - |
| TextVertical | - |
| UseCompatibleTextRendering | Enabled |
| WordWrap | - |
To enable GDI+ Compatible Mode, set the UseCompatibleTextRendering property to True.
Shortcut Keys
The table below lists all the keys supported while editing the ListBoxCell and the GcMultiRow control.
| Modifier | Key | ListBoxCell | GcMultiRow |
|---|---|---|---|
| None | Keys.End | Enabled | - |
| Keys.Home | Enabled | - | |
| Keys.Left | - | - | |
| Keys.Right | - | - | |
| Keys.Up | Enabled | - | |
| Keys.Down | Enabled | - | |
| Keys.Insert | - | - | |
| Keys.Delete | - | - | |
| Keys.BackSpace | - | - | |
| Keys.Space | Enabled | - | |
| Keys.PageUp | Enabled | - | |
| Keys.PageDown | Enabled | - |
Events
The GcMultiRow.CellEditedFormattedValueChanged event can be used to implement processing when the cell value is changed.