DataGridViewCheckBoxColumn Klasse

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

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: Object

DataGridViewElement

DataGridViewBand

DataGridViewColumn
DataGridViewCheckBoxColumn

Attribute: ToolboxBitmapAttribute

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 `false` zugrunde liegenden Wert ab, der als deaktiviertes Kontrollkästchen angezeigt wird.
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 `null`-Zellenwert entsprechenden Wert ab, der als deaktiviertes Kontrollkästchen angezeigt wird.
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 `true` zugrunde liegenden Wert ab, der als aktiviertes Kontrollkästchen angezeigt wird.
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)

Gilt für: