DataGridViewImageColumn.Image Proprietà

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ottiene o imposta l'immagine visualizzata nelle celle di questa colonna quando la proprietà Value della cella non è impostata e la proprietà ValueIsIcon della cella è impostata su 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

Valore della proprietà

Image

Oggetto Image da visualizzare. Il valore predefinito è null.

Esempio

Nell'esempio di codice seguente viene illustrato come impostare l'immagine predefinita. Questo esempio fa parte di un esempio più ampio disponibile in 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

Commenti

La Image proprietà specifica un'immagine visualizzata nelle celle senza valori quando la colonna non è associata a dati e la proprietà della ValueIsIcon cella è impostata su false. Per una colonna associata a dati le cui celle non dispongono di un'immagine associata, viene visualizzato un elemento grafico di errore standard.

Se si desidera visualizzare un Icon oggetto invece di , Imageimpostare la Icon proprietà e impostare la ValuesAreIcons proprietà su true. In questo modo si garantisce che il canale alfa dell'oggetto Icon venga disegnato correttamente. È anche possibile impostare la ValueIsIcon proprietà delle singole celle per indicare se la cella visualizza o Image il valore della Icon proprietà quando non è presente alcun valore di cella.

Vedi anche

• DataGridView
• Image
• Icon
• Icon
• ValuesAreIcons
• ValueIsIcon