DataGridViewImageColumn.Image Eigenschaft

  • Referenz

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Ruft das in den Zellen dieser Spalte angezeigte Bild ab, wenn die Value-Eigenschaft der Zelle nicht festgelegt ist und die ValueIsIcon-Eigenschaft auf false festgelegt ist, oder legt dieses fest.

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

Eigenschaftswert

Image

Das anzuzeigende Image. Der Standardwert ist null.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie das Standardbild festgelegt wird. Dieses Beispiel ist Teil eines größeren Beispiels, das in How to: Work with Image Columns in the Windows Forms DataGridView Control verfügbar ist.

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

Hinweise

Die Image Eigenschaft gibt ein Bild an, das in Zellen ohne Werte angezeigt wird, wenn die Spalte nicht datengebunden ist und die Eigenschaft der Zelle ValueIsIcon auf festgelegt falseist. Bei einer datengebundenen Spalte, deren Zellen kein zugeordnetes Bild aufweisen, wird eine Standardfehlergrafik angezeigt.

Wenn Sie anstelle Icon einer Image, die Eigenschaft stattdessen anzeigen möchten, legen Sie stattdessen die Icon Eigenschaft fest, und legen Sie die ValuesAreIcons Eigenschaft auf true. Dadurch wird sichergestellt, dass der Alphakanal des Icon Strichs korrekt gezeichnet wird. Sie können auch die ValueIsIcon Eigenschaft einzelner Zellen festlegen, um anzugeben, ob die Zelle den Wert der Image Icon Eigenschaft anzeigt, wenn kein Zellwert vorhanden ist.

Gilt für

Siehe auch