DataGridViewImageColumn.Image Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
.
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
Valor de propiedad
Image que se va a mostrar. De manera predeterminada, es null
.
Ejemplos
En el ejemplo de código siguiente se muestra cómo establecer la imagen predeterminada. Este ejemplo forma parte de un ejemplo más grande disponible en Cómo: Trabajar con columnas de imagen en el control DataGridView de 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
Comentarios
La Image propiedad especifica una imagen que se muestra en celdas sin valores cuando la columna no está enlazada a datos y la propiedad de ValueIsIcon la celda se establece false
en . Para una columna enlazada a datos cuyas celdas no tienen una imagen asociada, se muestra un gráfico de error estándar.
Si desea mostrar en Icon lugar de , Imageestablezca la Icon propiedad en su lugar y establezca la ValuesAreIcons propiedad true
en . Esto garantiza que el canal alfa de se Icon pinta correctamente. También puede establecer la ValueIsIcon propiedad de celdas individuales para indicar si la celda muestra o Image el valor de propiedad Icon cuando no hay ningún valor de celda.