The image cell has features similar to the .NET Framework's PictureBox control (System.Windows.Forms.PictureBox). The user can use the image cell to display an image in a cell.
Features
In addition to the Base Cell features, the following features can be used in the image cell.
- Display an Image
- Display an Icon
For more details on the features, refer to the ImageCell class.
Data Types
The image cell uses the Object value type and this type can be checked with the ImageCell.ValueType property. The ImageCell.ValueIsIcon property determines what datatype is used when the cell is shown. The System.Drawing.Image type value is used when the ValueIsIcon property is set to False. When the ValueIsIcon property is True, the System.Drawing.Icon type value is used. These types can be checked with the ImageCell.FormattedValueType property. The behavior during casting can be modified by overriding the ToString method of Object type. To modify the behavior when values are read in a cell, you can override the ImageCell.OnCellFormatting method. The behavior when the value is written back from the cell can be modified by overriding the ImageCell.OnCellParsing method.
Cell Edit Control
The image cell does not provide the cell edit control. The ImageCell.EditType property always returns a null reference (Nothing in Visual Basic).
Styles
The image cell supports the following CellStyle class members. You can set a cell style with the ImageCell.Style property.
| CellStyle Members | Enabled or Disabled |
| BackColor | Enabled |
| Border | Enabled |
| DataSourceNullValue | Enabled |
| DisabledBackColor | Enabled |
| DisabledForeColor | - |
| Font | - |
| ForeColor | - |
| Format | - |
| FormatProvider | - |
| GradientColors | Enabled |
| GradientDirection | Enabled |
| GradientStyle | Enabled |
| Image | Enabled |
| ImageAlign | Enabled |
| ImeMode | - |
| ImeSentenceMode | - |
| InputScope | - |
| LineAdjustment | - |
| Margin | Enabled |
| Multiline | - |
| NullValue | Enabled |
| Padding | Enabled |
| PatternColor | Enabled |
| PatternStyle | Enabled |
| SelectionBackColor | Enabled |
| SelectionForeColor | - |
| Tag | Enabled |
| TextAdjustment | - |
| TextAlign | - |
| TextAngle | - |
| TextEffect | - |
| TextImageRelation | - |
| TextIndent | - |
| TextVertical | - |
| UseCompatibleTextRendering | - |
| WordWrap | - |
The image set with the ImageCell.Style.Image property is drawn over the image set with ImageCell.Image.
Shortcut Keys
The image cell does not process shortcut keys.
Events
You can use the GcMultiRow.CellContentClick event event to get a click in the cell content area. You can use the GcMultiRow.CellContentDoubleClick event for a double-click.
For more information see the following topics:
- Display Image (ImageCell)
- Handle User Click (ImageCell)
- Display Alternate Image for Empty Value (ImageCell)