DataGridViewImageColumn.Image Свойство

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Исходный код:

DataGridViewImageColumn.cs

Получает или задает изображение, отображаемое в ячейках этого столбца, если свойство ячейки не задано, а свойство ячейки ValueValueIsIcon имеет 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

Значение свойства

Image

Отображаемый Image объект. Значение по умолчанию — null.

Примеры

В следующем примере кода показано, как задать изображение по умолчанию. Этот пример является частью более крупного примера, доступного в разделе "Практическое руководство. Работа с столбцами изображений в элементе управления 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

Комментарии

Свойство Image указывает изображение, отображаемое в ячейках без значений, если столбец не привязан к данным, а свойство ячейки ValueIsIcon имеет значение false. Для столбца, привязанного к данным, ячейки которых не имеют связанного изображения, отображается стандартный рисунок ошибки.

Если вы хотите отобразить IconImageвместо него, задайте Icon вместо свойства и задайте ValuesAreIcons для свойства значение true. Это гарантирует правильность окрашенного альфа-канала.Icon Можно также задать ValueIsIcon свойство отдельных ячеек, чтобы указать, отображается Image ли ячейка или Icon значение свойства, если нет значения ячейки.

См. также раздел

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