DataGridViewImageColumn.Image Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft ab oder legt das Bild, das in den Zellen dieser Spalte angezeigt wird, wenn die Eigenschaft der Zelle Value nicht festgelegt ist und die Eigenschaft der Zelle ValueIsIcon auf festgelegt falseist.
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 ImageEigenschaftswert
Der anzuzeigende Text Image . Der Standardwert lautet 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 false". Bei einer datengebundenen Spalte, deren Zellen kein zugeordnetes Bild aufweisen, wird eine Standardfehlergrafik angezeigt.
Wenn Sie anstelle eines Werts eine Icon Anstelle anzeigen möchten, legen Sie stattdessen die Icon Eigenschaft fest, und legen Sie die ValuesAreIcons Eigenschaft auf true.Image 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 Image Wert oder den Icon Eigenschaftswert anzeigt, wenn kein Zellwert vorhanden ist.
