DataGridViewImageCellLayout Enumeration

Note: This enumeration is new in the .NET Framework version 2.0.

Specifies the layout for an image contained in a DataGridViewCell.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

'Declaration
Public Enumeration DataGridViewImageCellLayout
'Usage
Dim instance As DataGridViewImageCellLayout

public enum DataGridViewImageCellLayout
public enum DataGridViewImageCellLayout

 Member nameDescription
NormalThe graphic is displayed centered using its native resolution. 
NotSetThe layout specification has not been set. 
StretchThe graphic is stretched by the percentages required to fit the width and height of the containing cell. 
ZoomThe 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 Sub Stretch(ByVal sender As Object, _
    ByVal e As EventArgs) Handles Button3.Click

    For Each column As DataGridViewImageColumn _
        In dataGridView1.Columns
        column.ImageLayout = DataGridViewImageCellLayout.Stretch
        column.Description = "Stretched image layout"
    Next
End Sub

Private Sub ZoomToImage(ByVal sender As Object, _
    ByVal e As EventArgs) Handles Button4.Click

    For Each column As DataGridViewImageColumn _
        In dataGridView1.Columns
        column.ImageLayout = DataGridViewImageCellLayout.Zoom
        column.Description = "Zoomed image layout"
    Next
End Sub

Private Sub NormalImage(ByVal sender As Object, _
    ByVal e As EventArgs) Handles Button5.Click

    For Each column As DataGridViewImageColumn _
        In dataGridView1.Columns
        column.ImageLayout = DataGridViewImageCellLayout.Normal
        column.Description = "Normal image layout"
    Next
End Sub

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0

Community Additions

ADD
Show: