DataGridViewImageColumn.Image Propriété

Référence

Définition

Espace de noms:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Obtient ou définit l'image affichée dans les cellules de cette colonne lorsque la propriété Value de la cellule n'est pas définie et que la propriété ValueIsIcon de la cellule a la valeur false.

public:
 property System::Drawing::Image ^ Image { System::Drawing::Image ^ get(); void set(System::Drawing::Image ^ value); };

public System.Drawing.Image Image { get; set; }

public System.Drawing.Image? Image { get; set; }

member this.Image : System.Drawing.Image with get, set

Public Property Image As Image

Valeur de propriété

Image

Image à afficher. La valeur par défaut est null.

Exemples

L’exemple de code suivant montre comment définir l’image par défaut. Cet exemple fait partie d’un exemple plus large disponible dans How to: Work with Image Columns dans le contrôle DataGridView Windows Forms.

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

Remarques

La Image propriété spécifie une image qui s’affiche dans des cellules sans valeurs lorsque la colonne n’est pas liée aux données et que la propriété de ValueIsIcon la cellule a la falsevaleur . Pour une colonne liée aux données dont les cellules n’ont pas d’image associée, un graphique d’erreur standard s’affiche.

Si vous souhaitez afficher un Icon au lieu d’un Image, définissez la propriété à la Icon place et définissez la ValuesAreIcons propriété sur true. Cela garantit que le canal alpha du Icon est correctement peint. Vous pouvez également définir la ValueIsIcon propriété de cellules individuelles pour indiquer si la cellule affiche la valeur de la Image propriété ou Icon lorsqu’il n’y a pas de valeur de cellule.

S’applique à

Partager via