DataGridViewImageColumn.Image Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém ou define a imagem exibida nas células desta coluna quando a propriedade da Value célula não está definida e a propriedade da ValueIsIcon célula está definida para 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, setPublic Property Image As ImageValor de Propriedade
A Image exposição para mostrar. A predefinição é null.
Exemplos
O exemplo de código seguinte demonstra como definir a imagem padrão. Este exemplo faz parte de um exemplo maior disponível em Como trabalhar: Trabalhar com Colunas de Imagem no Windows Forms Controlo DataGridView.
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
Observações
A Image propriedade especifica uma imagem que é exibida em células sem valores quando a coluna não está limitada por dados e a propriedade da ValueIsIcon célula está definida para false. Para uma coluna limitada por dados cujas células não têm uma imagem associada, é apresentado um gráfico de erro padrão.
Se quiser mostrar um Icon em vez de um Image, defina a Icon propriedade em vez disso e defina a ValuesAreIcons propriedade para true. Isto garante que o canal alfa do Icon está pintado corretamente. Também pode definir a ValueIsIcon propriedade das células individuais para indicar se a célula mostra o valor ou Image o Icon valor da propriedade quando não existe valor da célula.
