Dieser Artikel wurde manuell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. |
Übersetzung
Original
|
DataGridViewButtonColumn-Klasse
Enthält eine Auflistung von DataGridViewButtonCell-Objekten.
System.Windows.Forms.DataGridViewElement
System.Windows.Forms.DataGridViewBand
System.Windows.Forms.DataGridViewColumn
System.Windows.Forms.DataGridViewButtonColumn
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
Der DataGridViewButtonColumn-Typ macht die folgenden Member verfügbar.
| Name | Beschreibung | |
|---|---|---|
|
DataGridViewButtonColumn | Initialisiert eine neue Instanz der DataGridViewButtonColumn-Klasse im Standardzustand. |
| Name | Beschreibung | |
|---|---|---|
|
AutoSizeMode | Ruft den Modus ab, in dem die Spalte automatisch ihre Breite anpasst, oder legt diesen Modus fest. (Von DataGridViewColumn geerbt.) |
|
CellTemplate | Ruft die zum Erstellen neuer Zellen verwendete Vorlage ab oder legt diese fest. (Überschreibt DataGridViewColumn.CellTemplate.) |
|
CellType | Ruft den Laufzeittyp der Zellvorlage ab. (Von DataGridViewColumn geerbt.) |
|
ContextMenuStrip | Ruft das Kontextmenü für die Spalte ab oder legt dieses fest. (Von DataGridViewColumn geerbt.) |
|
DataGridView | Ruft das diesem Element zugeordnete DataGridView-Steuerelement ab. (Von DataGridViewElement geerbt.) |
|
DataPropertyName | Ruft den Namen der Datenquelleneigenschaft oder Datenbankspalte ab, an die DataGridViewColumn gebunden ist, oder legt diesen Namen fest. (Von DataGridViewColumn geerbt.) |
|
DefaultCellStyle | Ruft das Standardzellenformat der Spalte ab oder legt dieses fest. (Überschreibt DataGridViewColumn.DefaultCellStyle.) |
|
DefaultHeaderCellType | Ruft den Laufzeittyp der Standardheaderzelle ab oder legt diesen fest. (Von DataGridViewBand geerbt.) |
|
Displayed | Ruft einen Wert ab, der angibt, ob das Band gegenwärtig auf dem Bildschirm angezeigt wird. (Von DataGridViewBand geerbt.) |
|
DisplayIndex | Ruft die Anzeigereihenfolge der Spalte relativ zu den derzeit angezeigten Spalten ab oder legt sie fest. (Von DataGridViewColumn geerbt.) |
|
DividerWidth | Ruft die Breite des Spaltenunterteilers in Pixel ab oder legt sie fest. (Von DataGridViewColumn geerbt.) |
|
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.) |
|
FlatStyle | Ruft die flache Darstellung der Schaltflächenzellen in der Spalte ab oder legt diese fest. |
|
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.) |
|
HasDefaultCellStyle | Ruft einen Wert ab, der angibt, ob die DefaultCellStyle-Eigenschaft festgelegt wurde. (Von DataGridViewBand geerbt.) |
|
HeaderCell | Ruft die DataGridViewColumnHeaderCell ab, die den Spaltenheader darstellt, oder legt sie fest. (Von DataGridViewColumn geerbt.) |
|
HeaderCellCore | Ruft die Headerzelle von DataGridViewBand ab oder legt diese fest. (Von DataGridViewBand geerbt.) |
|
HeaderText | Ruft den Beschriftungstext für die Headerzelle der Spalte ab oder legt ihn fest. (Von DataGridViewColumn geerbt.) |
|
Index | Ruft die relative Position des Bands im DataGridView-Steuerelement ab. (Von DataGridViewBand geerbt.) |
|
InheritedAutoSizeMode | Ruft den für die Spalte gültigen Modus zum Festlegen der Größe ab. (Von DataGridViewColumn geerbt.) |
|
InheritedStyle | Ruft den Zellstil ab, der gegenwärtig auf die Spalte angewendet wird. (Von DataGridViewColumn geerbt.) |
|
IsDataBound | Ruft einen Wert ab, der angibt, ob die Spalte an eine Datenquelle gebunden ist. (Von DataGridViewColumn geerbt.) |
|
IsRow | Ruft einen Wert ab, der angibt, ob das Band eine Zeile darstellt. (Von DataGridViewBand geerbt.) |
|
MinimumWidth | Ruft die minimale Breite der Spalte in Pixel ab oder legt sie fest. (Von DataGridViewColumn geerbt.) |
|
Name | Ruft den Namen der Spalte ab oder legt ihn fest. (Von DataGridViewColumn geerbt.) |
|
ReadOnly | Ruft einen Wert ab, der angibt, ob der Benutzer die Zellen der Spalte bearbeiten kann, oder legt diesen Wert fest. (Von DataGridViewColumn geerbt.) |
|
Resizable | Ruft einen Wert ab, der angibt, ob die Größe der Spalte geändert werden kann, oder legt diesen fest. (Von DataGridViewColumn geerbt.) |
|
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.) |
|
Site | Infrastruktur. Ruft die Site der Spalte ab oder legt sie fest. (Von DataGridViewColumn geerbt.) |
|
SortMode | Ruft den Sortiermodus für die Spalte ab oder legt diesen fest. (Von DataGridViewColumn geerbt.) |
|
State | Ruft den Benutzeroberflächenzustand des Elements ab. (Von DataGridViewElement geerbt.) |
|
Tag | Ruft das Objekt ab, das dem Band zuzuordnende Daten enthält, oder legt dieses fest. (Von DataGridViewBand geerbt.) |
|
Text | Ruft den Standardtext ab, der in der Schaltflächenzelle angezeigt wird, oder legt diesen fest. |
|
ToolTipText | Ruft den für QuickInfos verwendeten Text ab oder legt diesen fest. (Von DataGridViewColumn geerbt.) |
|
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. |
|
ValueType | Ruft den Datentyp der Werte in den Zellen der Spalte ab oder legt ihn fest. (Von DataGridViewColumn geerbt.) |
|
Visible | Ruft einen Wert ab, der angibt, ob die Spalte sichtbar ist, oder legt diesen Wert fest. (Von DataGridViewColumn geerbt.) |
|
Width | Ruft die aktuelle Breite der Spalte ab oder legt sie fest. (Von DataGridViewColumn geerbt.) |
| Name | Beschreibung | |
|---|---|---|
|
Clone | Erstellt eine genaue Kopie dieser Spalte. (Überschreibt DataGridViewColumn.Clone().) |
|
Dispose() | Gibt sämtliche von DataGridViewBand verwendeten Ressourcen frei. (Von DataGridViewBand geerbt.) |
|
Dispose(Boolean) | Gibt die vom DataGridViewBand verwendeten nicht verwalteten Ressourcen und optional auch die verwalteten Ressourcen frei. (Von DataGridViewColumn geerbt.) |
|
Equals(Object) | Bestimmt, ob das angegebene Object und das aktuelle Object gleich sind. (Von Object geerbt.) |
|
Finalize | Gibt die dem Band zugeordneten Ressourcen frei. (Von DataGridViewBand geerbt.) |
|
GetHashCode | Fungiert als Hashfunktion für einen bestimmten Typ. (Von Object geerbt.) |
|
GetPreferredWidth | Berechnet die ideale Breite der Spalte auf der Grundlage der angegebenen Kriterien. (Von DataGridViewColumn geerbt.) |
|
GetType | Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.) |
|
MemberwiseClone | Erstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.) |
|
OnDataGridViewChanged | Wird aufgerufen, wenn das Band einer anderen DataGridView zugeordnet wird. (Von DataGridViewBand geerbt.) |
|
RaiseCellClick | Löst das DataGridView.CellClick-Ereignis aus. (Von DataGridViewElement geerbt.) |
|
RaiseCellContentClick | Löst das DataGridView.CellContentClick-Ereignis aus. (Von DataGridViewElement geerbt.) |
|
RaiseCellContentDoubleClick | Löst das DataGridView.CellContentDoubleClick-Ereignis aus. (Von DataGridViewElement geerbt.) |
|
RaiseCellValueChanged | Löst das DataGridView.CellValueChanged-Ereignis aus. (Von DataGridViewElement geerbt.) |
|
RaiseDataError | Löst das DataGridView.DataError-Ereignis aus. (Von DataGridViewElement geerbt.) |
|
RaiseMouseWheel | Löst das Control.MouseWheel-Ereignis aus. (Von DataGridViewElement geerbt.) |
|
ToString | Ruft eine Zeichenfolge ab, die die Spalte beschreibt. (Überschreibt DataGridViewColumn.ToString().) |
| Name | Beschreibung | |
|---|---|---|
|
Disposed | Tritt ein, wenn die DataGridViewColumn freigegeben ist. (Von DataGridViewColumn geerbt.) |
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
|
|---|
|
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"); } } }
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.
Hinweis