DataGridViewImageCellLayout Enumeration

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Specifies the layout for an image contained in a DataGridViewCell.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public enum DataGridViewImageCellLayout

Member nameDescription
Normal

The graphic is displayed centered using its native resolution.

NotSet

The layout specification has not been set.

Stretch

The graphic is stretched by the percentages required to fit the width and height of the containing cell.

Zoom

The graphic is uniformly enlarged until it fills the width or height of the containing cell.

The following code example illustrates the use of this type. This example is part of a larger example available in How to: Work with Image Columns in the Windows Forms DataGridView Control.

private void Stretch(object sender, EventArgs e)
{
    foreach (DataGridViewImageColumn column in
        dataGridView1.Columns)
    {
        column.ImageLayout = DataGridViewImageCellLayout.Stretch;
        column.Description = "Stretched";
    }
}

private void ZoomToImage(object sender, EventArgs e)
{

    foreach (DataGridViewImageColumn column in
        dataGridView1.Columns)
    {
        column.ImageLayout = DataGridViewImageCellLayout.Zoom;
        column.Description = "Zoomed";
    }
}

private void NormalImage(object sender, EventArgs e)
{

    foreach (DataGridViewImageColumn column in
        dataGridView1.Columns)
    {
        column.ImageLayout = DataGridViewImageCellLayout.Normal;
        column.Description = "Normal";
    }
}

.NET Framework
Available since 2.0
Return to top
Show: