DataGridViewImageColumn.Description Eigenschaft

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

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 eine Zeichenfolge ab, die das Bild der Spalte beschreibt, oder legt diese fest.

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

Eigenschaftswert

String

Die Textbeschreibung des Bilds der Spalte. Der Standardwert ist Empty.

Attribute: BrowsableAttribute

Ausnahmen

InvalidOperationException

Der Wert der CellTemplate-Eigenschaft ist null.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die Description -Eigenschaft verwendet wird, um das Bildlayout widerzuspiegeln. Dieses Beispiel ist Teil eines größeren Beispiels, das unter Vorgehensweise: Arbeiten mit Bildspalten im Windows Forms DataGridView-Steuerelement verfügbar ist.

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

Hinweise

Sie können die Description -Eigenschaft verwenden, um das von der Image - oder Icon -Eigenschaft bereitgestellte Bild zu beschreiben. Diese Beschreibung stellt eine barrierefreie Alternative zum Bild bereit. Darüber hinaus wird der Beschreibungstext verwendet, wenn der Zellwert in die Zwischenablage kopiert wird.

Durch Das Abrufen oder Festlegen dieser Eigenschaft wird die Description Eigenschaft des Objekts abgerufen oder festgelegt, das von der CellTemplate -Eigenschaft zurückgegeben wird. Durch Festlegen dieser Eigenschaft wird auch die Description -Eigenschaft jeder Zelle in der Spalte festgelegt. Um den angegebenen Wert für einzelne Zellen außer Kraft zu setzen, legen Sie die Zellwerte fest, nachdem Sie den Spaltenwert festgelegt haben.

Gilt für: