DataGridViewCheckBoxColumn Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Enthält eine Auflistung von DataGridViewCheckBoxCell-Objekten.
public ref class DataGridViewCheckBoxColumn : System::Windows::Forms::DataGridViewColumn
[System.Drawing.ToolboxBitmap(typeof(System.Windows.Forms.DataGridViewCheckBoxColumn), "DataGridViewCheckBoxColumn.bmp")]
public class DataGridViewCheckBoxColumn : System.Windows.Forms.DataGridViewColumn
[System.Drawing.ToolboxBitmap(typeof(System.Windows.Forms.DataGridViewCheckBoxColumn), "DataGridViewCheckBoxColumn")]
public class DataGridViewCheckBoxColumn : System.Windows.Forms.DataGridViewColumn
[<System.Drawing.ToolboxBitmap(typeof(System.Windows.Forms.DataGridViewCheckBoxColumn), "DataGridViewCheckBoxColumn.bmp")>]
type DataGridViewCheckBoxColumn = class
inherit DataGridViewColumn
[<System.Drawing.ToolboxBitmap(typeof(System.Windows.Forms.DataGridViewCheckBoxColumn), "DataGridViewCheckBoxColumn")>]
type DataGridViewCheckBoxColumn = class
inherit DataGridViewColumn
Public Class DataGridViewCheckBoxColumn
Inherits DataGridViewColumn
- Vererbung
- Attribute
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie sie verwenden, DataGridViewCheckBoxColumn um zu markieren, welche Mitarbeiter nicht im Büro sind. Dieses Beispiel ist Teil eines größeren Beispiels, das im Thema Klassenübersicht DataGridViewComboBoxColumn verfügbar ist.
private:
void AddOutOfOfficeColumn()
{
DataGridViewCheckBoxColumn^ column = gcnew DataGridViewCheckBoxColumn();
{
column->HeaderText = ColumnName::OutOfOffice.ToString();
column->Name = ColumnName::OutOfOffice.ToString();
column->AutoSizeMode =
DataGridViewAutoSizeColumnMode::DisplayedCells;
column->FlatStyle = FlatStyle::Standard;
column->ThreeState = true;
column->CellTemplate = gcnew DataGridViewCheckBoxCell();
column->CellTemplate->Style->BackColor = Color::Beige;
}
DataGridView1->Columns->Insert(0, column);
}
private void AddOutOfOfficeColumn()
{
DataGridViewCheckBoxColumn column = new DataGridViewCheckBoxColumn();
{
column.HeaderText = ColumnName.OutOfOffice.ToString();
column.Name = ColumnName.OutOfOffice.ToString();
column.AutoSizeMode =
DataGridViewAutoSizeColumnMode.DisplayedCells;
column.FlatStyle = FlatStyle.Standard;
column.ThreeState = true;
column.CellTemplate = new DataGridViewCheckBoxCell();
column.CellTemplate.Style.BackColor = Color.Beige;
}
DataGridView1.Columns.Insert(0, column);
}
Private Sub AddOutOfOfficeColumn()
Dim column As New DataGridViewCheckBoxColumn()
With column
.HeaderText = ColumnName.OutOfOffice.ToString()
.Name = ColumnName.OutOfOffice.ToString()
.AutoSizeMode = DataGridViewAutoSizeColumnMode.DisplayedCells
.FlatStyle = FlatStyle.Standard
.CellTemplate = New DataGridViewCheckBoxCell()
.CellTemplate.Style.BackColor = Color.Beige
End With
DataGridView1.Columns.Insert(0, column)
End Sub
Hinweise
Die DataGridViewCheckBoxColumn -Klasse ist ein spezialisierter Typ der -Klasse, die DataGridViewColumn zum logischen Hosten von Zellen verwendet wird, die den binären Zustand angeben. Eine DataGridViewCheckBoxColumn hat eine zugeordnet DataGridViewCheckBoxCell in jeder DataGridViewRow , die es überschneidet. Jede Zelle stellt eine Benutzeroberfläche (UI) bereit, die einem CheckBox Steuerelement ähnelt.
Der Standardmäßige Sortiermodus für diesen Spaltentyp ist NotSortable.
Normalerweise sind die Werte von Kontrollkästchen entweder für die Speicherung wie für beliebige andere Daten oder die Durchführung von Massenvorgängen bestimmt. Wenn Sie sofort reagieren möchten, wenn Benutzer auf ein Kontrollkästchen klicken, können Sie das DataGridView.CellContentClick-Ereignis behandeln. Allerdings tritt dieses Ereignis ein, ehe der Zellwert aktualisiert wird. Wenn Sie den neuen Wert zum Zeitpunkt des Klicks benötigen, besteht eine Möglichkeit darin, den erwarteten Wert auf Grundlage des aktuellen Werts zu berechnen. Eine andere Möglichkeit besteht darin, die Änderung sofort zu bestätigen und das DataGridView.CellValueChanged-Ereignis zu behandeln, um darauf zu reagieren. Um die Änderung zu committen, wenn auf die Zelle geklickt wird, müssen Sie das DataGridView.CurrentCellDirtyStateChanged-Ereignis behandeln. Wenn die aktuelle Zelle eine Kontrollkästchenzelle ist, rufen Sie im Handler die DataGridView.CommitEdit-Methode auf und geben den Commit-Wert ein.
Hinweise für Vererber
Wenn Sie von DataGridViewCheckBoxColumn abgeleitet werden und der abgeleiteten Klasse neue Eigenschaften hinzufügen, müssen Sie die Clone() -Methode überschreiben, um die neuen Eigenschaften während des Klonvorgangs zu kopieren. Sie sollten auch die -Methode der Basisklasse Clone() aufrufen, damit die Eigenschaften der Basisklasse in die neue Zelle kopiert werden.
Konstruktoren
DataGridViewCheckBoxColumn() |
Initialisiert eine neue Instanz der DataGridViewCheckBoxColumn-Klasse im Standardzustand. |
DataGridViewCheckBoxColumn(Boolean) |
Initialisiert eine neue Instanz der DataGridViewCheckBoxColumn und konfiguriert sie für die Anzeige von Kontrollkästchen mit zwei oder drei Zuständen. |
Eigenschaften
AutoSizeMode |
Ruft den Modus ab, in dem die Spalte automatisch ihre Breite anpasst, oder legt diesen Modus fest. (Geerbt von DataGridViewColumn) |
CellTemplate |
Ruft die zum Erstellen neuer Zellen verwendete Vorlage ab oder legt diese fest. |
CellType |
Ruft den Laufzeittyp der Zellvorlage ab. (Geerbt von DataGridViewColumn) |
ContextMenuStrip |
Ruft das Kontextmenü für die Spalte ab oder legt dieses fest. (Geerbt von DataGridViewColumn) |
DataGridView |
Ruft das diesem Element zugeordnete DataGridView-Steuerelement ab. (Geerbt von DataGridViewElement) |
DataPropertyName |
Ruft den Namen der Datenquelleneigenschaft oder Datenbankspalte ab, an die DataGridViewColumn gebunden ist, oder legt diesen Namen fest. (Geerbt von DataGridViewColumn) |
DefaultCellStyle |
Ruft das Standardzellenformat der Spalte ab oder legt dieses fest. |
DefaultHeaderCellType |
Ruft den Laufzeittyp der Standardheaderzelle ab oder legt diesen fest. (Geerbt von DataGridViewBand) |
Displayed |
Ruft einen Wert ab, der angibt, ob das Band gegenwärtig auf dem Bildschirm angezeigt wird. (Geerbt von DataGridViewBand) |
DisplayIndex |
Ruft die Anzeigereihenfolge der Spalte relativ zu den derzeit angezeigten Spalten ab oder legt sie fest. (Geerbt von DataGridViewColumn) |
DividerWidth |
Ruft die Breite des Spaltenunterteilers in Pixel ab oder legt sie fest. (Geerbt von DataGridViewColumn) |
FalseValue |
Ruft den einem Zellwert von |
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. (Geerbt von DataGridViewColumn) |
FlatStyle |
Ruft das Format für die flache Darstellung der Kontrollkästchenzellen ab oder legt dieses 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. (Geerbt von DataGridViewColumn) |
HasDefaultCellStyle |
Ruft einen Wert ab, der angibt, ob die DefaultCellStyle-Eigenschaft festgelegt wurde. (Geerbt von DataGridViewBand) |
HeaderCell |
Ruft die DataGridViewColumnHeaderCell ab, die den Spaltenheader darstellt, oder legt sie fest. (Geerbt von DataGridViewColumn) |
HeaderCellCore |
Ruft die Headerzelle von DataGridViewBand ab oder legt diese fest. (Geerbt von DataGridViewBand) |
HeaderText |
Ruft den Beschriftungstext für die Headerzelle der Spalte ab oder legt ihn fest. (Geerbt von DataGridViewColumn) |
IndeterminateValue |
Ruft den einem unbestimmten oder |
Index |
Ruft die relative Position des Bands im DataGridView-Steuerelement ab. (Geerbt von DataGridViewBand) |
InheritedAutoSizeMode |
Ruft den für die Spalte gültigen Modus zum Festlegen der Größe ab. (Geerbt von DataGridViewColumn) |
InheritedStyle |
Ruft den Zellstil ab, der gegenwärtig auf die Spalte angewendet wird. (Geerbt von DataGridViewColumn) |
IsDataBound |
Ruft einen Wert ab, der angibt, ob die Spalte an eine Datenquelle gebunden ist. (Geerbt von DataGridViewColumn) |
IsRow |
Ruft einen Wert ab, der angibt, ob das Band eine Zeile darstellt. (Geerbt von DataGridViewBand) |
MinimumWidth |
Ruft die minimale Breite der Spalte in Pixel ab oder legt sie fest. (Geerbt von DataGridViewColumn) |
Name |
Ruft den Namen der Spalte ab oder legt ihn fest. (Geerbt von DataGridViewColumn) |
ReadOnly |
Ruft einen Wert ab, der angibt, ob der Benutzer die Zellen der Spalte bearbeiten kann, oder legt diesen Wert fest. (Geerbt von DataGridViewColumn) |
Resizable |
Ruft einen Wert ab, der angibt, ob die Größe der Spalte geändert werden kann, oder legt diesen fest. (Geerbt von DataGridViewColumn) |
Selected |
Ruft einen Wert ab, der angibt, ob sich das Band in einem ausgewählten Benutzeroberflächenzustand befindet, oder legt diesen Wert fest. (Geerbt von DataGridViewBand) |
Site |
Ruft die Site der Spalte ab oder legt sie fest. (Geerbt von DataGridViewColumn) |
SortMode |
Ruft den Sortiermodus für die Spalte ab oder legt diesen fest. (Geerbt von DataGridViewColumn) |
State |
Ruft den Benutzeroberflächenzustand des Elements ab. (Geerbt von DataGridViewElement) |
Tag |
Ruft das Objekt ab, das dem Band zuzuordnende Daten enthält, oder legt dieses fest. (Geerbt von DataGridViewBand) |
ThreeState |
Ruft einen Wert ab, der angibt, ob für die gehosteten Kontrollkästchenzellen drei anstelle von zwei Aktivierungszuständen zulässig sind, oder legt diesen fest. |
ToolTipText |
Ruft den für QuickInfos verwendeten Text ab oder legt diesen fest. (Geerbt von DataGridViewColumn) |
TrueValue |
Ruft den einem Zellenwert von |
ValueType |
Ruft den Datentyp der Werte in den Zellen der Spalte ab oder legt ihn fest. (Geerbt von DataGridViewColumn) |
Visible |
Ruft einen Wert ab, der angibt, ob die Spalte sichtbar ist, oder legt ihn fest. (Geerbt von DataGridViewColumn) |
Width |
Ruft die aktuelle Breite der Spalte ab oder legt sie fest. (Geerbt von DataGridViewColumn) |
Methoden
Clone() |
Erstellt eine genaue Kopie dieser Zelle. (Geerbt von DataGridViewColumn) |
Dispose() |
Gibt alle vom DataGridViewBand verwendeten Ressourcen frei. (Geerbt von DataGridViewBand) |
Dispose(Boolean) |
Gibt die von DataGridViewBand verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei. (Geerbt von DataGridViewColumn) |
Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
GetHashCode() |
Fungiert als Standardhashfunktion. (Geerbt von Object) |
GetPreferredWidth(DataGridViewAutoSizeColumnMode, Boolean) |
Berechnet die ideale Breite der Spalte auf der Grundlage der angegebenen Kriterien. (Geerbt von DataGridViewColumn) |
GetType() |
Ruft den Type der aktuellen Instanz ab. (Geerbt von Object) |
MemberwiseClone() |
Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object) |
OnDataGridViewChanged() |
Wird aufgerufen, wenn das Band einer anderen DataGridView zugeordnet wird. (Geerbt von DataGridViewBand) |
RaiseCellClick(DataGridViewCellEventArgs) |
Löst das CellClick-Ereignis aus. (Geerbt von DataGridViewElement) |
RaiseCellContentClick(DataGridViewCellEventArgs) |
Löst das CellContentClick-Ereignis aus. (Geerbt von DataGridViewElement) |
RaiseCellContentDoubleClick(DataGridViewCellEventArgs) |
Löst das CellContentDoubleClick-Ereignis aus. (Geerbt von DataGridViewElement) |
RaiseCellValueChanged(DataGridViewCellEventArgs) |
Löst das CellValueChanged-Ereignis aus. (Geerbt von DataGridViewElement) |
RaiseDataError(DataGridViewDataErrorEventArgs) |
Löst das DataError-Ereignis aus. (Geerbt von DataGridViewElement) |
RaiseMouseWheel(MouseEventArgs) |
Löst das MouseWheel-Ereignis aus. (Geerbt von DataGridViewElement) |
ToString() |
Ruft eine Zeichenfolge ab, die die Spalte beschreibt. |
Ereignisse
Disposed |
Tritt ein, wenn die DataGridViewColumn freigegeben ist. (Geerbt von DataGridViewColumn) |