DataGridViewButtonColumn.Text Свойство

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Исходный код:

DataGridViewButtonColumn.cs

Возвращает или задает текст по умолчанию, отображаемый в ячейке кнопки.

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

Значение свойства

String

Объект, String содержащий текст. Значение по умолчанию — Empty.

Исключения

InvalidOperationException

При задании CellTemplate этого свойства значение свойства равно null.

Примеры

В следующем примере кода показано, как использовать представление DataGridViewButtonColumn о продажах, сделанных сотрудником. Свойство Text используется для задания заголовка столбца. Этот пример является частью более крупного примера, доступного в DataGridViewComboBoxColumn разделе обзора класса.

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

Комментарии

Каждый DataGridViewButtonCell столбец, содержащийся в качестве UseColumnTextForButtonValue значения true свойства, отображает Text значение свойства на кнопке ячейки.

Если есть связанный DataGridView элемент управления, изменение этого свойства обновляет отображение столбца.

См. также раздел

• DataGridView
• DataGridViewButtonCell
• UseColumnTextForButtonValue
• UseColumnTextForButtonValue
• CellTemplate