DataGridViewImageColumn.Description Eigenschap

Definitie

Naamruimte:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll
Bron:
DataGridViewImageColumn.cs
Bron:
DataGridViewImageColumn.cs
Bron:
DataGridViewImageColumn.cs
Bron:
DataGridViewImageColumn.cs
Bron:
DataGridViewImageColumn.cs

Hiermee wordt een tekenreeks opgehaald of ingesteld die de afbeelding van de kolom beschrijft.

public:
 property System::String ^ Description { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.Browsable(true)]
public string Description { get; set; }
[<System.ComponentModel.Browsable(true)>]
member this.Description : string with get, set
Public Property Description As String

Waarde van eigenschap

String

De tekstuele beschrijving van de kolomafbeelding. De standaardwaarde is Empty.

Kenmerken
BrowsableAttribute

Uitzonderingen

InvalidOperationException

De waarde van de CellTemplate eigenschap is null.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u de eigenschap gebruikt om de Description afbeeldingsindeling weer te geven. Dit voorbeeld maakt deel uit van een groter voorbeeld dat beschikbaar is in How to: Work with Image Columns in the Windows Forms DataGridView Control.

void Stretch( Object^ sender, EventArgs^ e )
{
   System::Collections::IEnumerator^ myEnum = dataGridView1->Columns->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      DataGridViewImageColumn^ column = safe_cast<DataGridViewImageColumn^>(myEnum->Current);
      column->ImageLayout = DataGridViewImageCellLayout::Stretch;
      column->Description = L"Stretched";
   }
}

void ZoomToImage( Object^ sender, EventArgs^ e )
{
   System::Collections::IEnumerator^ myEnum1 = dataGridView1->Columns->GetEnumerator();
   while ( myEnum1->MoveNext() )
   {
      DataGridViewImageColumn^ column = safe_cast<DataGridViewImageColumn^>(myEnum1->Current);
      column->ImageLayout = DataGridViewImageCellLayout::Zoom;
      column->Description = L"Zoomed";
   }
}

void NormalImage( Object^ sender, EventArgs^ e )
{
   System::Collections::IEnumerator^ myEnum2 = dataGridView1->Columns->GetEnumerator();
   while ( myEnum2->MoveNext() )
   {
      DataGridViewImageColumn^ column = safe_cast<DataGridViewImageColumn^>(myEnum2->Current);
      column->ImageLayout = DataGridViewImageCellLayout::Normal;
      column->Description = L"Normal";
   }
}

private void Stretch(object sender, EventArgs e)
{
    foreach (DataGridViewImageColumn column in
        dataGridView1.Columns)
    {
        column.ImageLayout = DataGridViewImageCellLayout.Stretch;
        column.Description = "Stretched";
    }
}

private void ZoomToImage(object sender, EventArgs e)
{

    foreach (DataGridViewImageColumn column in
        dataGridView1.Columns)
    {
        column.ImageLayout = DataGridViewImageCellLayout.Zoom;
        column.Description = "Zoomed";
    }
}

private void NormalImage(object sender, EventArgs e)
{

    foreach (DataGridViewImageColumn column in
        dataGridView1.Columns)
    {
        column.ImageLayout = DataGridViewImageCellLayout.Normal;
        column.Description = "Normal";
    }
}

Private Sub Stretch(ByVal sender As Object, _
    ByVal e As EventArgs) Handles Button3.Click

    For Each column As DataGridViewImageColumn _
        In dataGridView1.Columns
        column.ImageLayout = DataGridViewImageCellLayout.Stretch
        column.Description = "Stretched image layout"
    Next
End Sub

Private Sub ZoomToImage(ByVal sender As Object, _
    ByVal e As EventArgs) Handles Button4.Click

    For Each column As DataGridViewImageColumn _
        In dataGridView1.Columns
        column.ImageLayout = DataGridViewImageCellLayout.Zoom
        column.Description = "Zoomed image layout"
    Next
End Sub

Private Sub NormalImage(ByVal sender As Object, _
    ByVal e As EventArgs) Handles Button5.Click

    For Each column As DataGridViewImageColumn _
        In dataGridView1.Columns
        column.ImageLayout = DataGridViewImageCellLayout.Normal
        column.Description = "Normal image layout"
    Next
End Sub

Opmerkingen

U kunt de Description eigenschap gebruiken om de afbeelding van de Image of Icon eigenschap te beschrijven. Deze beschrijving biedt een toegankelijk alternatief voor de afbeelding. Daarnaast wordt de beschrijvingstekst gebruikt wanneer de celwaarde naar het Klembord wordt gekopieerd.

Als u deze eigenschap ophaalt of instelt, wordt de Description eigenschap van het object dat door de CellTemplate eigenschap wordt geretourneerd, opgehaald of ingesteld. Als u deze eigenschap instelt, wordt ook de Description eigenschap van elke cel in de kolom ingesteld. Als u de opgegeven waarde voor afzonderlijke cellen wilt overschrijven, stelt u de celwaarden in nadat u de kolomwaarde hebt ingesteld.

Van toepassing op

Zie ook