DataGridViewButtonColumn.UseColumnTextForButtonValue Свойство

Определение

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

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

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

public:
 property bool UseColumnTextForButtonValue { bool get(); void set(bool value); };

public bool UseColumnTextForButtonValue { get; set; }

member this.UseColumnTextForButtonValue : bool with get, set

Public Property UseColumnTextForButtonValue As Boolean

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

Boolean

true, если значение свойства Text отображается на кнопках в столбце; false если значение свойства FormattedValue каждой ячейки отображается на кнопке, которую она содержит. Значение по умолчанию — false.

Исключения

InvalidOperationException

Значение свойства CellTemplate равно null.

Примеры

В следующем примере кода показано использование этого свойства.

private void CreateUnboundButtonColumn()
{
    // Initialize the button column.
    DataGridViewButtonColumn buttonColumn =
        new DataGridViewButtonColumn();
    buttonColumn.Name = "Details";
    buttonColumn.HeaderText = "Details";
    buttonColumn.Text = "View Details";

    // Use the Text property for the button text for all cells rather
    // than using each cell's value as the text for its own button.
    buttonColumn.UseColumnTextForButtonValue = true;

    // Add the button column to the control.
    dataGridView1.Columns.Insert(0, buttonColumn);
}

Private Sub CreateUnboundButtonColumn()

    ' Initialize the button column.
    Dim buttonColumn As New DataGridViewButtonColumn

    With buttonColumn
        .HeaderText = "Details"
        .Name = "Details"
        .Text = "View Details"

        ' Use the Text property for the button text for all cells rather
        ' than using each cell's value as the text for its own button.
        .UseColumnTextForButtonValue = True
    End With

    ' Add the button column to the control.
    dataGridView1.Columns.Insert(0, buttonColumn)

End Sub

Комментарии

По умолчанию ячейка DataGridViewCell.FormattedValue кнопки отображается в виде текста на кнопке. Свойство UseColumnTextForButtonValue позволяет задать текст кнопки для каждой ячейки или использовать Text значение свойства для всех ячеек кнопки.

Получение или установка этого свойства получает или задает UseColumnTextForButtonValue свойство объекта, возвращаемого свойством CellTemplate . Установка этого свойства также задает UseColumnTextForButtonValue свойство каждой ячейки в столбце и обновляет отображение столбца. Чтобы переопределить указанное значение для отдельных ячеек, задайте значения ячеек после установки значения столбца.

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

• DataGridView
• Text
• FormattedValue
• CellTemplate
• DataGridViewButtonCell
• UseColumnTextForButtonValue
• Практическое руководство. Отключение кнопок в кнопочном столбе элемента управления DataGridView в Windows Forms