DataGridViewButtonColumn.Text Propiedad

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Obtiene o establece el texto mostrado de manera predeterminada en el botón de barra de herramientas.

public:
 property System::String ^ Text { System::String ^ get(); void set(System::String ^ value); };

public string Text { get; set; }

member this.Text : string with get, set

Public Property Text As String

Valor de propiedad

String

Una cadena String que contiene el texto. De manera predeterminada, es Empty.

Excepciones

InvalidOperationException

Al establecer esta propiedad, el valor de la propiedad CellTemplate es null.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar un DataGridViewButtonColumn para ver las ventas realizadas por un empleado. La Text propiedad se usa para establecer el encabezado de columna. Este ejemplo forma parte de un ejemplo más grande disponible en el tema de información general de la DataGridViewComboBoxColumn clase.

private:
    void AddButtonColumn()
    {
        DataGridViewButtonColumn^ buttons = gcnew DataGridViewButtonColumn();
        {
            buttons->HeaderText = "Sales";
            buttons->Text = "Sales";
            buttons->UseColumnTextForButtonValue = true;
            buttons->AutoSizeMode =
                DataGridViewAutoSizeColumnMode::AllCells;
            buttons->FlatStyle = FlatStyle::Standard;
            buttons->CellTemplate->Style->BackColor = Color::Honeydew;
            buttons->DisplayIndex = 0;
        }

        DataGridView1->Columns->Add(buttons);

    }

private void AddButtonColumn()
{
    DataGridViewButtonColumn buttons = new DataGridViewButtonColumn();
    {
        buttons.HeaderText = "Sales";
        buttons.Text = "Sales";
        buttons.UseColumnTextForButtonValue = true;
        buttons.AutoSizeMode =
            DataGridViewAutoSizeColumnMode.AllCells;
        buttons.FlatStyle = FlatStyle.Standard;
        buttons.CellTemplate.Style.BackColor = Color.Honeydew;
        buttons.DisplayIndex = 0;
    }

    DataGridView1.Columns.Add(buttons);
}

Private Sub AddButtonColumn()
    Dim buttons As New DataGridViewButtonColumn()
    With buttons
        .HeaderText = "Sales"
        .Text = "Sales"
        .UseColumnTextForButtonValue = True
        .AutoSizeMode = DataGridViewAutoSizeColumnMode.DisplayedCells
        .FlatStyle = FlatStyle.Standard
        .CellTemplate.Style.BackColor = Color.Honeydew
        .DisplayIndex = 0
    End With

    DataGridView1.Columns.Add(buttons)

End Sub

Comentarios

Cada DataGridViewButtonCell uno contenido en la columna que tiene como valor UseColumnTextForButtonValue de propiedad muestra el Text valor de true propiedad en el botón de la celda.

Si hay un control asociado DataGridView , al cambiar esta propiedad se actualiza la presentación de columnas.

Consulte también

• DataGridView
• DataGridViewButtonCell
• UseColumnTextForButtonValue
• UseColumnTextForButtonValue
• CellTemplate