Compartilhar via

DataGridViewImageColumn.Image Propriedade

  • Referência

Definição

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Obtém ou define a imagem exibida nas células desta coluna quando a propriedade Value da célula não está definida e a propriedade ValueIsIcon da célula está definida como false.

public:
 property System::Drawing::Image ^ Image { System::Drawing::Image ^ get(); void set(System::Drawing::Image ^ value); };
public System.Drawing.Image Image { get; set; }
member this.Image : System.Drawing.Image with get, set
Public Property Image As Image

Valor da propriedade

Image

O Image a ser exibido. O padrão é null.

Exemplos

O exemplo de código a seguir demonstra como definir a imagem padrão. Este exemplo faz parte de um exemplo maior disponível em How to: Work with Image Columns in the Windows Forms DataGridView Control.

void CreateColumns()
{
   DataGridViewImageColumn^ imageColumn;
   int columnCount = 0;
   do
   {
      Bitmap^ unMarked = blank;
      imageColumn = gcnew DataGridViewImageColumn;
      
      //Add twice the padding for the left and 
      //right sides of the cell.
      imageColumn->Width = x->Width + 2 * bitmapPadding + 1;
      imageColumn->Image = unMarked;
      dataGridView1->Columns->Add( imageColumn );
      columnCount = columnCount + 1;
   }
   while ( columnCount < 3 );
}

private void CreateColumns()
{
    DataGridViewImageColumn imageColumn;
    int columnCount = 0;
    do
    {
        Bitmap unMarked = blank;
        imageColumn = new DataGridViewImageColumn();

        //Add twice the padding for the left and 
        //right sides of the cell.
        imageColumn.Width = x.Width + 2 * bitmapPadding + 1;

        imageColumn.Image = unMarked;
        dataGridView1.Columns.Add(imageColumn);
        columnCount = columnCount + 1;
    }
    while (columnCount < 3);
}

Private Sub CreateColumns()

    Dim imageColumn As DataGridViewImageColumn
    Dim columnCount As Integer = 0
    Do
        Dim unMarked As Bitmap = blank
        imageColumn = New DataGridViewImageColumn()

        ' Add twice the padding for the left and 
        ' right sides of the cell.
        imageColumn.Width = x.Width + 2 * bitmapPadding + 1

        imageColumn.Image = unMarked
        imageColumn.ImageLayout = DataGridViewImageCellLayout.NotSet
        imageColumn.Description = "default image layout"
        dataGridView1.Columns.Add(imageColumn)
        columnCount = columnCount + 1
    Loop While columnCount < 3
End Sub

Comentários

A Image propriedade especifica uma imagem exibida em células sem valores quando a coluna não está associada a dados e a propriedade da ValueIsIcon célula é definida como false. Para uma coluna associada a dados cujas células não têm uma imagem associada, um gráfico de erro padrão é exibido.

Se você quiser exibir um Icon em vez de um Image, defina a Icon propriedade e defina a ValuesAreIcons propriedade como true. Isso garante que o canal alfa do Icon seja pintado corretamente. Você também pode definir a ValueIsIcon propriedade de células individuais para indicar se a célula exibe o Image valor da propriedade ou quando Icon não há valor de célula.

Aplica-se a

Confira também