The track bar cell has features similar to the .NET Framework's TrackBar (System.Windows.Forms.TrackBar). The user can use the track bar cell to visually input numeric values based on the slider and the scale.
Features
In addition to the Base Cell features, the following features can also be used in the track bar cell.
- Slider
- Scale
- Change to Horizontal or Vertical direction
For more details on each feature, refer to the TrackBarCell class.
Data Types
The track bar cell uses the Object type value. This type can be checked with the TrackBarCell.ValueType property. The edited value in the track bar cell is the one cast into an Integer type. This type can be checked with the TrackBarCell.FormattedValueType property. Override the TrackBarCell.OnCellFormatting method to modify the behavior when values are read in a cell. Override the TrackBarCell.OnCellParsing method to modify the behavior when the value is written back from the cell.
Cell Edit Control
The track bar cell does not support the cell edit control. The TrackBarCell.EditType property always returns a null reference (Nothing in Visual Basic).
Styles
The track bar cell supports the following CellStyle class members. You can set the cell style with the TrackBarCell.Style property.
| CellStyle Members | Enabled or Disabled |
|---|---|
| BackColor | Enabled |
| BackgroundGradientEffect | Enabled |
| Border | Enabled |
| DataSourceNullValue | Enabled |
| DisabledBackColor | Enabled |
| DisabledForeColor | - |
| DisabledGradientEffect | Enabled |
| EditingBackColor | - |
| EditingForeColor | - |
| Font | - |
| ForeColor | - |
| Format | - |
| FormatProvider | - |
| Image | - |
| ImageAlign | - |
| ImeMode | - |
| ImeSentenceMode | - |
| InputScope | - |
| LineAdjustment | - |
| Margin | Enabled |
| MouseOverBackColor | Enabled |
| MouseOverForeColor | - |
| MouseOverGradientEffect | Enabled |
| Multiline | - |
| NullValue | - |
| Padding | Enabled |
| PatternColor | Enabled |
| PatternStyle | Enabled |
| SelectionBackColor | Enabled |
| SelectionForeColor | - |
| SelectionGradientEffect | Enabled |
| Tag | Enabled |
| TextAdjustment | - |
| TextAlign | - |
| TextAngle | - |
| TextEffect | - |
| TextImageRelation | - |
| TextIndent | - |
| TextVertical | - |
| UseCompatibleTextRendering | - |
| WordWrap | - |
Shortcut Keys
The table below lists keys processed when the track bar cell is in edit mode and lists keys that are processed by the GcMultiRow control.
| Modifier | Key | TrackBarCell | 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 | - | - | |
| 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 | - | - | |
| Keys.C | - | - | |
| Keys.V | - | - | |
| Keys.X | - | - |
Events
You can use the GcMultiRow.CellContentClick event to implement processing when clicking 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.
Comparison with Standard Control
The table below shows a comparison between major properties of the track bar cell and the System.Windows.Forms.TrackBar control.
| TrackBarCell | TrackBar |
|---|---|
| LargeChange | LargeChange |
| Maximum | Maximum |
| Minimum | Minimum |
| Orientation | Orientation |
| SmallChange | SmallChange |
| TickFrequency | TickFrequency |
| TickStyle | TickStyle |