DataGridViewImageColumn.Image Свойство

Определение

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

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

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

Примеры

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

Комментарии

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

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

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

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