Dieser Artikel wurde manuell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen.
Übersetzung
Original
Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

DataGridViewButtonColumn-Klasse

Enthält eine Auflistung von DataGridViewButtonCell-Objekten.

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)
[ToolboxBitmapAttribute(typeof(DataGridViewButtonColumn), "DataGridViewButtonColumn.bmp")]
public class DataGridViewButtonColumn : DataGridViewColumn

Der DataGridViewButtonColumn-Typ macht die folgenden Member verfügbar.

  Name Beschreibung
Öffentliche Methode DataGridViewButtonColumn Initialisiert eine neue Instanz der DataGridViewButtonColumn-Klasse im Standardzustand.
Zum Seitenanfang
  Name Beschreibung
Öffentliche Eigenschaft AutoSizeMode Ruft den Modus ab, in dem die Spalte automatisch ihre Breite anpasst, oder legt diesen Modus fest. (Von DataGridViewColumn geerbt.)
Öffentliche Eigenschaft CellTemplate Ruft die zum Erstellen neuer Zellen verwendete Vorlage ab oder legt diese fest. (Überschreibt DataGridViewColumn.CellTemplate.)
Öffentliche Eigenschaft CellType Ruft den Laufzeittyp der Zellvorlage ab. (Von DataGridViewColumn geerbt.)
Öffentliche Eigenschaft ContextMenuStrip Ruft das Kontextmenü für die Spalte ab oder legt dieses fest. (Von DataGridViewColumn geerbt.)
Öffentliche Eigenschaft DataGridView Ruft das diesem Element zugeordnete DataGridView-Steuerelement ab. (Von DataGridViewElement geerbt.)
Öffentliche Eigenschaft DataPropertyName Ruft den Namen der Datenquelleneigenschaft oder Datenbankspalte ab, an die DataGridViewColumn gebunden ist, oder legt diesen Namen fest. (Von DataGridViewColumn geerbt.)
Öffentliche Eigenschaft DefaultCellStyle Ruft das Standardzellenformat der Spalte ab oder legt dieses fest. (Überschreibt DataGridViewColumn.DefaultCellStyle.)
Öffentliche Eigenschaft DefaultHeaderCellType Ruft den Laufzeittyp der Standardheaderzelle ab oder legt diesen fest. (Von DataGridViewBand geerbt.)
Öffentliche Eigenschaft Displayed Ruft einen Wert ab, der angibt, ob das Band gegenwärtig auf dem Bildschirm angezeigt wird. (Von DataGridViewBand geerbt.)
Öffentliche Eigenschaft DisplayIndex Ruft die Anzeigereihenfolge der Spalte relativ zu den derzeit angezeigten Spalten ab oder legt sie fest. (Von DataGridViewColumn geerbt.)
Öffentliche Eigenschaft DividerWidth Ruft die Breite des Spaltenunterteilers in Pixel ab oder legt sie fest. (Von DataGridViewColumn geerbt.)
Öffentliche Eigenschaft FillWeight Ruft einen Wert ab, der die Breite der Spalte im Füllmodus relativ zur Breite anderer im Steuerelement vorhandener Spalten im Füllmodus darstellt, oder legt diesen Wert fest. (Von DataGridViewColumn geerbt.)
Öffentliche Eigenschaft FlatStyle Ruft die flache Darstellung der Schaltflächenzellen in der Spalte ab oder legt diese fest.
Öffentliche Eigenschaft Frozen Ruft einen Wert ab, der angibt, ob eine Spalte verschoben wird, wenn ein Benutzer einen horizontalen Bildlauf durch das DataGridView-Steuerelement durchführt, oder legt diesen Wert fest. (Von DataGridViewColumn geerbt.)
Öffentliche Eigenschaft HasDefaultCellStyle Ruft einen Wert ab, der angibt, ob die DefaultCellStyle-Eigenschaft festgelegt wurde. (Von DataGridViewBand geerbt.)
Öffentliche Eigenschaft HeaderCell Ruft die DataGridViewColumnHeaderCell ab, die den Spaltenheader darstellt, oder legt sie fest. (Von DataGridViewColumn geerbt.)
Geschützte Eigenschaft HeaderCellCore Ruft die Headerzelle von DataGridViewBand ab oder legt diese fest. (Von DataGridViewBand geerbt.)
Öffentliche Eigenschaft HeaderText Ruft den Beschriftungstext für die Headerzelle der Spalte ab oder legt ihn fest. (Von DataGridViewColumn geerbt.)
Öffentliche Eigenschaft Index Ruft die relative Position des Bands im DataGridView-Steuerelement ab. (Von DataGridViewBand geerbt.)
Öffentliche Eigenschaft InheritedAutoSizeMode Ruft den für die Spalte gültigen Modus zum Festlegen der Größe ab. (Von DataGridViewColumn geerbt.)
Öffentliche Eigenschaft InheritedStyle Ruft den Zellstil ab, der gegenwärtig auf die Spalte angewendet wird. (Von DataGridViewColumn geerbt.)
Öffentliche Eigenschaft IsDataBound Ruft einen Wert ab, der angibt, ob die Spalte an eine Datenquelle gebunden ist. (Von DataGridViewColumn geerbt.)
Geschützte Eigenschaft IsRow Ruft einen Wert ab, der angibt, ob das Band eine Zeile darstellt. (Von DataGridViewBand geerbt.)
Öffentliche Eigenschaft MinimumWidth Ruft die minimale Breite der Spalte in Pixel ab oder legt sie fest. (Von DataGridViewColumn geerbt.)
Öffentliche Eigenschaft Name Ruft den Namen der Spalte ab oder legt ihn fest. (Von DataGridViewColumn geerbt.)
Öffentliche Eigenschaft ReadOnly Ruft einen Wert ab, der angibt, ob der Benutzer die Zellen der Spalte bearbeiten kann, oder legt diesen Wert fest. (Von DataGridViewColumn geerbt.)
Öffentliche Eigenschaft Resizable Ruft einen Wert ab, der angibt, ob die Größe der Spalte geändert werden kann, oder legt diesen fest. (Von DataGridViewColumn geerbt.)
Öffentliche Eigenschaft Selected Ruft einen Wert ab, der angibt, ob sich das Band in einem ausgewählten Benutzeroberflächenzustand befindet, oder legt diesen Wert fest. (Von DataGridViewBand geerbt.)
Öffentliche Eigenschaft Site Infrastruktur. Ruft die Site der Spalte ab oder legt sie fest. (Von DataGridViewColumn geerbt.)
Öffentliche Eigenschaft SortMode Ruft den Sortiermodus für die Spalte ab oder legt diesen fest. (Von DataGridViewColumn geerbt.)
Öffentliche Eigenschaft State Ruft den Benutzeroberflächenzustand des Elements ab. (Von DataGridViewElement geerbt.)
Öffentliche Eigenschaft Tag Ruft das Objekt ab, das dem Band zuzuordnende Daten enthält, oder legt dieses fest. (Von DataGridViewBand geerbt.)
Öffentliche Eigenschaft Text Ruft den Standardtext ab, der in der Schaltflächenzelle angezeigt wird, oder legt diesen fest.
Öffentliche Eigenschaft ToolTipText Ruft den für QuickInfos verwendeten Text ab oder legt diesen fest. (Von DataGridViewColumn geerbt.)
Öffentliche Eigenschaft UseColumnTextForButtonValue Ruft einen Wert ab, der angibt, ob der Text-Eigenschaftswert für Zellen in dieser Spalte als Schaltflächentext angezeigt wird, oder legt diesen fest.
Öffentliche Eigenschaft ValueType Ruft den Datentyp der Werte in den Zellen der Spalte ab oder legt ihn fest. (Von DataGridViewColumn geerbt.)
Öffentliche Eigenschaft Visible Ruft einen Wert ab, der angibt, ob die Spalte sichtbar ist, oder legt diesen Wert fest. (Von DataGridViewColumn geerbt.)
Öffentliche Eigenschaft Width Ruft die aktuelle Breite der Spalte ab oder legt sie fest. (Von DataGridViewColumn geerbt.)
Zum Seitenanfang
  Name Beschreibung
Öffentliche Methode Clone Erstellt eine genaue Kopie dieser Spalte. (Überschreibt DataGridViewColumn.Clone().)
Öffentliche Methode Dispose() Gibt sämtliche von DataGridViewBand verwendeten Ressourcen frei. (Von DataGridViewBand geerbt.)
Geschützte Methode Dispose(Boolean) Gibt die vom DataGridViewBand verwendeten nicht verwalteten Ressourcen und optional auch die verwalteten Ressourcen frei. (Von DataGridViewColumn geerbt.)
Öffentliche Methode Equals(Object) Bestimmt, ob das angegebene Object und das aktuelle Object gleich sind. (Von Object geerbt.)
Geschützte Methode Finalize Gibt die dem Band zugeordneten Ressourcen frei. (Von DataGridViewBand geerbt.)
Öffentliche Methode GetHashCode Fungiert als Hashfunktion für einen bestimmten Typ. (Von Object geerbt.)
Öffentliche Methode GetPreferredWidth Berechnet die ideale Breite der Spalte auf der Grundlage der angegebenen Kriterien. (Von DataGridViewColumn geerbt.)
Öffentliche Methode GetType Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.)
Geschützte Methode MemberwiseClone Erstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.)
Geschützte Methode OnDataGridViewChanged Wird aufgerufen, wenn das Band einer anderen DataGridView zugeordnet wird. (Von DataGridViewBand geerbt.)
Geschützte Methode RaiseCellClick Löst das DataGridView.CellClick-Ereignis aus. (Von DataGridViewElement geerbt.)
Geschützte Methode RaiseCellContentClick Löst das DataGridView.CellContentClick-Ereignis aus. (Von DataGridViewElement geerbt.)
Geschützte Methode RaiseCellContentDoubleClick Löst das DataGridView.CellContentDoubleClick-Ereignis aus. (Von DataGridViewElement geerbt.)
Geschützte Methode RaiseCellValueChanged Löst das DataGridView.CellValueChanged-Ereignis aus. (Von DataGridViewElement geerbt.)
Geschützte Methode RaiseDataError Löst das DataGridView.DataError-Ereignis aus. (Von DataGridViewElement geerbt.)
Geschützte Methode RaiseMouseWheel Löst das Control.MouseWheel-Ereignis aus. (Von DataGridViewElement geerbt.)
Öffentliche Methode ToString Ruft eine Zeichenfolge ab, die die Spalte beschreibt. (Überschreibt DataGridViewColumn.ToString().)
Zum Seitenanfang
  Name Beschreibung
Öffentliches Ereignis Disposed Tritt ein, wenn die DataGridViewColumn freigegeben ist. (Von DataGridViewColumn geerbt.)
Zum Seitenanfang

Die DataGridViewButtonColumn-Klasse ist ein spezialisierter Typ der DataGridViewColumn-Klasse, die als logischer Host von Zellen verwendet wird, die auf eine einfache Benutzereingabe reagieren. Eine DataGridViewButtonColumn verfügt in jeder DataGridViewRow, mit der sie eine gemeinsame Schnittmenge bildet, über eine zugeordnete DataGridViewButtonCell. Jede Zelle stellt eine einem Button-Steuerelement ähnliche Benutzeroberfläche bereit.

Wenn Sie für jede Zelle denselben Schaltflächentext anzeigen möchten, legen Sie die UseColumnTextForButtonValue-Eigenschaft auf true fest, und legen Sie die Text-Eigenschaft auf den gewünschten Schaltflächentext fest.

Der Standardsortiermodus für diesen Spaltentyp ist NotSortable.

Um auf das Klicken auf eine Schaltfläche durch den Benutzer zu reagieren, behandeln Sie das DataGridView.CellClick-Ereignis oder das DataGridView.CellContentClick-Ereignis. Im Ereignishandler können Sie mit der DataGridViewCellEventArgs.ColumnIndex-Eigenschaft ermitteln, ob in die Schaltflächenspalte geklickt wurde. Mithilfe der DataGridViewCellEventArgs.RowIndex-Eigenschaft können Sie ermitteln, ob auf eine Schaltflächenzelle oder auf die Spaltenüberschrift geklickt wurde.

Hinweis Hinweis

Wenn visuelle Stile aktiviert sind, werden die Schaltflächen in einer Schaltflächenspalte mit einem ButtonRenderer gezeichnet, und über Eigenschaften wie DefaultCellStyle angegebene Zellenstile haben keine Auswirkungen.

Hinweise zur Vererbung

Wenn Sie aus DataGridViewButtonColumn ableiten und der abgeleiteten Klasse neue Eigenschaften hinzufügen, muss die Clone-Methode überschrieben werden, damit die neuen Eigenschaften während der Klonvorgänge kopiert werden. Sie sollten auch die Clone-Methode der Basisklasse aufrufen, damit die Eigenschaften der Basisklasse in die neue Zelle kopiert werden.

Im folgenden Codebeispiel wird veranschaulicht, wie eine DataGridViewButtonColumn verwendet wird, um Aktionen für bestimmte Zeilen auszuführen. In diesem Beispiel bestimmt ein DataGridView.CellClick-Ereignishandler zuerst, ob auf eine Schaltflächenzelle geklickt wurde. Anschließend wird ein Geschäftsobjekt abgerufen, das der Zeile zugeordnet ist. Dieses Beispiel ist Teil eines umfangreicheren Beispiels in Gewusst wie: Zugreifen auf Objekte in einer Windows Forms-DataGridViewComboBoxCell-Dropdownliste.


public class Form1 : Form
{
    private List<Employee> employees = new List<Employee>();
    private List<Task> tasks = new List<Task>();
    private Button reportButton = new Button();
    private DataGridView dataGridView1 = new DataGridView();

    [STAThread]
    public static void Main()
    {
        Application.Run(new Form1());
    }

    public Form1()
    {
        dataGridView1.Dock = DockStyle.Fill;
        dataGridView1.AutoSizeColumnsMode = 
            DataGridViewAutoSizeColumnsMode.AllCells;
        reportButton.Text = "Generate Report";
        reportButton.Dock = DockStyle.Top;
        reportButton.Click += new EventHandler(reportButton_Click);

        Controls.Add(dataGridView1);
        Controls.Add(reportButton);
        Load += new EventHandler(Form1_Load);
        Text = "DataGridViewComboBoxColumn Demo";
    }

    // Initializes the data source and populates the DataGridView control.
    private void Form1_Load(object sender, EventArgs e)
    {
        PopulateLists();
        dataGridView1.AutoGenerateColumns = false;
        dataGridView1.DataSource = tasks;
        AddColumns();
    }

    // Populates the employees and tasks lists. 
    private void PopulateLists()
    {
        employees.Add(new Employee("Harry"));
        employees.Add(new Employee("Sally"));
        employees.Add(new Employee("Roy"));
        employees.Add(new Employee("Pris"));
        tasks.Add(new Task(1, employees[1]));
        tasks.Add(new Task(2));
        tasks.Add(new Task(3, employees[2]));
        tasks.Add(new Task(4));
    }

    // Configures columns for the DataGridView control.
    private void AddColumns()
    {
        DataGridViewTextBoxColumn idColumn = 
            new DataGridViewTextBoxColumn();
        idColumn.Name = "Task";
        idColumn.DataPropertyName = "Id";
        idColumn.ReadOnly = true;

        DataGridViewComboBoxColumn assignedToColumn = 
            new DataGridViewComboBoxColumn();

        // Populate the combo box drop-down list with Employee objects. 
        foreach (Employee e in employees) assignedToColumn.Items.Add(e);

        // Add "unassigned" to the drop-down list and display it for 
        // empty AssignedTo values or when the user presses CTRL+0. 
        assignedToColumn.Items.Add("unassigned");
        assignedToColumn.DefaultCellStyle.NullValue = "unassigned";

        assignedToColumn.Name = "Assigned To";
        assignedToColumn.DataPropertyName = "AssignedTo";
        assignedToColumn.AutoComplete = true;
        assignedToColumn.DisplayMember = "Name";
        assignedToColumn.ValueMember = "Self";

        // Add a button column. 
        DataGridViewButtonColumn buttonColumn = 
            new DataGridViewButtonColumn();
        buttonColumn.HeaderText = "";
        buttonColumn.Name = "Status Request";
        buttonColumn.Text = "Request Status";
        buttonColumn.UseColumnTextForButtonValue = true;

        dataGridView1.Columns.Add(idColumn);
        dataGridView1.Columns.Add(assignedToColumn);
        dataGridView1.Columns.Add(buttonColumn);

        // Add a CellClick handler to handle clicks in the button column.
        dataGridView1.CellClick +=
            new DataGridViewCellEventHandler(dataGridView1_CellClick);
    }

    // Reports on task assignments. 
    private void reportButton_Click(object sender, EventArgs e)
    {
        StringBuilder report = new StringBuilder();
        foreach (Task t in tasks)
        {
            String assignment = 
                t.AssignedTo == null ? 
                "unassigned" : "assigned to " + t.AssignedTo.Name;
            report.AppendFormat("Task {0} is {1}.", t.Id, assignment);
            report.Append(Environment.NewLine);
        }
        MessageBox.Show(report.ToString(), "Task Assignments");
    }

    // Calls the Employee.RequestStatus method.
    void dataGridView1_CellClick(object sender, DataGridViewCellEventArgs e)
    {
        // Ignore clicks that are not on button cells. 
        if (e.RowIndex < 0 || e.ColumnIndex !=
            dataGridView1.Columns["Status Request"].Index) return;

        // Retrieve the task ID.
        Int32 taskID = (Int32)dataGridView1[0, e.RowIndex].Value;

        // Retrieve the Employee object from the "Assigned To" cell.
        Employee assignedTo = dataGridView1.Rows[e.RowIndex]
            .Cells["Assigned To"].Value as Employee;

        // Request status through the Employee object if present. 
        if (assignedTo != null)
        {
            assignedTo.RequestStatus(taskID);
        }
        else
        {
            MessageBox.Show(String.Format(
                "Task {0} is unassigned.", taskID), "Status Request");
        }
    }

}


.NET Framework

Unterstützt in: 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
Fanden Sie dies hilfreich?
(1500 verbleibende Zeichen)
Community-Inhalt Hinzufügen
Anmerkungen FAQ