DataGridViewImageColumn.Description Vlastnost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

DataGridViewImageColumn.cs

Získá nebo nastaví řetězec, který popisuje obrázek sloupce.

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

Hodnota vlastnosti

String

Textový popis obrázku sloupce. Výchozí hodnota je Empty.

Atributy

BrowsableAttribute

Výjimky

InvalidOperationException

Hodnota CellTemplate vlastnosti je null.

Příklady

Následující příklad kódu ukazuje, jak použít Description vlastnost k zobrazení rozložení obrázku. Tento příklad je součástí většího příkladu, který je k dispozici v části Postupy: Práce se sloupci obrázků v ovládacím prvku Windows Forms DataGridView.

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

Poznámky

Vlastnost můžete použít Description k popisu obrázku poskytnutého vlastností Image nebo Icon vlastnosti. Tento popis poskytuje přístupnou alternativu k obrázku. Kromě toho se text popisu použije při zkopírování hodnoty buňky do schránky.

Získání nebo nastavení této vlastnosti získá nebo nastaví Description vlastnost objektu vráceného CellTemplate vlastností. Nastavení této vlastnosti také nastaví Description vlastnost každé buňky ve sloupci. Pokud chcete přepsat zadanou hodnotu pro jednotlivé buňky, nastavte hodnoty buněk po nastavení hodnoty sloupce.

Viz také

• DataGridView
• Image
• Icon
• CellTemplate
• DataGridViewImageCell
• Description