DataGridViewImageColumn.Image Propiedad

Definición

Obtiene o establece la imagen mostrada en las celdas de esta columna cuando no está establecida la propiedad Value de la celda y la propiedad ValueIsIcon de la celda está establecida en false.Gets or sets the image displayed in the cells of this column when the cell's Value property is not set and the cell's ValueIsIcon property is set to 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 de propiedad

Image que se va a mostrar.The Image to display. De manera predeterminada, es null.The default is null.

Ejemplos

En el ejemplo de código siguiente se muestra cómo establecer la imagen predeterminada.The following code example demonstrates how to set the default image. Este ejemplo forma parte de un ejemplo más grande disponible en cómo: Trabajar con columnas de imagen en el controlDataGridView Windows Forms.This example is part of a larger example available 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

Comentarios

La Image propiedad especifica una imagen que se muestra en las celdas sin valores cuando la columna no está enlazada a datos y la propiedad ValueIsIcon de la celda está falseestablecida en.The Image property specifies an image that is displayed in cells with no values when the column is not data-bound and the cell's ValueIsIcon property is set to false. En el caso de una columna enlazada a datos cuyas celdas no tienen una imagen asociada, se muestra un gráfico de error estándar.For a data-bound column whose cells do not have an associated image, a standard error graphic is displayed.

Si desea Icon Mostrar en lugar Icon Imagede, establezca la propiedad en su lugar y establezca la ValuesAreIcons propiedad en true.If you want to display an Icon instead of an Image, set the Icon property instead and set the ValuesAreIcons property to true. Esto garantiza que el canal alfa de Icon se pinte correctamente.This ensures that the alpha channel of the Icon is painted correctly. También puede establecer la ValueIsIcon propiedad de celdas individuales para indicar si la celda Image muestra o el valor de Icon la propiedad cuando no hay ningún valor de celda.You can also set the ValueIsIcon property of individual cells to indicate whether the cell displays the Image or the Icon property value when there is no cell value.

Se aplica a

Consulte también: