DataGridViewImageColumn.Description Propiedad

Definición

Obtiene o establece una cadena que describe la imagen de la columna.Gets or sets a string that describes the column's image.

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

Valor de propiedad

La descripción textual de la imagen de la columna.The textual description of the column image. El valor predeterminado es Empty.The default is Empty.

Atributos

Excepciones

El valor de la propiedad CellTemplate es null.The value of the CellTemplate property is null.

Ejemplos

En el ejemplo de código siguiente se muestra cómo utilizar la propiedad Description para reflejar el diseño de la imagen.The following code example demonstrates how to use the Description property to reflect the image layout. Este ejemplo forma parte de un ejemplo más grande disponible en Cómo: trabajar con columnas de imagen en el control DataGridView Windows Forms.This example is part of a larger example available 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

Comentarios

Puede usar la propiedad Description para describir la imagen proporcionada por la propiedad Image o Icon.You can use the Description property to describe the image provided by the Image or Icon property. Esta descripción proporciona una alternativa accesible a la imagen.This description provides an accessible alternative to the image. Además, se usa el texto de Descripción cuando el valor de la celda se copia en el portapapeles.Additionally, the description text is used when the cell value is copied onto the Clipboard.

Al obtener o establecer esta propiedad se obtiene o establece la propiedad Description del objeto devuelto por la propiedad CellTemplate.Getting or setting this property gets or sets the Description property of the object returned by the CellTemplate property. Al establecer esta propiedad también se establece la propiedad Description de cada celda de la columna.Setting this property also sets the Description property of every cell in the column. Para reemplazar el valor especificado para celdas individuales, establezca los valores de la celda después de establecer el valor de la columna.To override the specified value for individual cells, set the cell values after you set the column value.

Se aplica a

Consulte también: