DataGridViewButtonColumn.UseColumnTextForButtonValue Właściwość

Odwołanie

Definicja

Przestrzeń nazw:: System.Windows.Forms

Zestaw:: System.Windows.Forms.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Pobiera lub ustawia wartość wskazującą, czy Text wartość właściwości jest wyświetlana jako tekst przycisku dla komórek w tej kolumnie.

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

Wartość właściwości

Boolean

trueText jeśli wartość właściwości jest wyświetlana na przyciskach w kolumnie; false jeśli FormattedValue wartość właściwości każdej komórki jest wyświetlana na przycisku. Wartość domyślna to false.

Wyjątki

InvalidOperationException

Wartość CellTemplate właściwości to null.

Przykłady

W poniższym przykładzie kodu pokazano użycie tej właściwości.

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

Uwagi

Domyślnie DataGridViewCell.FormattedValue komórka przycisku jest wyświetlana jako tekst na przycisku. Właściwość UseColumnTextForButtonValue umożliwia ustawienie tekstu przycisku dla każdej komórki lub użycie Text wartości właściwości dla wszystkich komórek przycisku.

Pobieranie lub ustawianie tej właściwości powoduje pobranie lub ustawienie UseColumnTextForButtonValue właściwości obiektu zwróconego CellTemplate przez właściwość . Ustawienie tej właściwości powoduje również ustawienie UseColumnTextForButtonValue właściwości każdej komórki w kolumnie i odświeżenie wyświetlania kolumny. Aby zastąpić określoną wartość dla poszczególnych komórek, ustaw wartości komórek po ustawieniu wartości kolumny.

Dotyczy