DataGridViewImageColumn.Image Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene o imposta l'immagine visualizzata nelle celle di questa colonna quando la proprietà Value della cella non è impostata e la proprietà ValueIsIcon della cella è impostata su 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, set
Public Property Image As Image
Valore della proprietà
Oggetto Image da visualizzare. Il valore predefinito è null
.
Esempio
Nell'esempio di codice seguente viene illustrato come impostare l'immagine predefinita. Questo esempio fa parte di un esempio più ampio disponibile in How to: Work with Image Columns in the Windows Forms DataGridView Control.
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
Commenti
La Image proprietà specifica un'immagine visualizzata nelle celle senza valori quando la colonna non è associata a dati e la proprietà della ValueIsIcon cella è impostata su false
. Per una colonna associata a dati le cui celle non dispongono di un'immagine associata, viene visualizzato un elemento grafico di errore standard.
Se si desidera visualizzare un Icon oggetto invece di , Imageimpostare la Icon proprietà e impostare la ValuesAreIcons proprietà su true
. In questo modo si garantisce che il canale alfa dell'oggetto Icon venga disegnato correttamente. È anche possibile impostare la ValueIsIcon proprietà delle singole celle per indicare se la cella visualizza o Image il valore della Icon proprietà quando non è presente alcun valore di cella.