Data GridViewlmage Column

This column, not surprisingly, contains cells of type DataGridViewlmageCell, which support the rendering of images directly within the grid's cells. This cell type provides a very handy and easy-to-use capability in the DataGridView control that used to be fairly painful to achieve with the DataGrid control. This column type exposeslmage and ImageLayout properties in addition to the usual base class properties. Setting the column's Image property results in that image being displayed by default for all the cells in that column. The ImageLayout property takes aDataGridViewlmageCellLayout enumeration value. The values of this enumeration and their effect on the rendering of an image in the grid are described in Table 6.3.

Table 6.3. DataGridViewlmageCellLayout Enumeration Values and Effects

Value

Effect

NotSet

This is the default and indicates that the layout behavior has not been explicitly specified. The resulting behavior of the cell is the same as if Normal had been explicitly set.

Normal

The image is rendered at its native size and centered in the cell. Depending on the size of the cell, any portions of the image that are outside the bounds of the cell will be clipped.

Stretch

The image is stretched or shrunk in both width and height so that it fills the cell and no clipping occurs. No attempt is made to maintain the aspect ratio (width/height) of the image.

Zoom

The image is resized so that it fits within the cell without clipping, and the aspect ratio (width/height) is maintained so that no distortion of the image occurs.

In addition to setting a default image at the column level, you can set the Value property at the cell level, either explicitly through code or implicitly through data binding. The value can be set to any type that can be converted to an Image object for display in the cell. Natively in .NET, this means that the value can either be an Image or a byte array that contains a serialized Image.

0 0

Post a comment