DataGridViewCheckBoxColumn Klasse

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.

Hosten einer 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.bmp")>]
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 mit einer DataGridViewCheckBoxColumn Kennzeichnung versehen können, welche Mitarbeiter nicht im Büro sind. Dieses Beispiel ist Teil eines größeren Beispiels, das DataGridViewComboBoxColumn im Thema "Klassenübersicht" 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 spezieller Typ der Klasse, die DataGridViewColumn zum logischen Hosten von Zellen verwendet wird, die den binären Zustand angeben. A DataGridViewCheckBoxColumn weist eine zuordnungsbedingte DataGridViewCheckBoxCell Verbindung auf DataGridViewRow , die sie überschneidet. Jede Zelle stellt eine Benutzeroberfläche bereit, die einem CheckBox Steuerelement ähnelt.

Der Standardsortierungsmodus für diesen Spaltentyp lautet NotSortable.

In der Regel sind Kontrollkästchen-Zellwerte entweder zur Speicherung vorgesehen, wie jede andere Daten, oder für Massenoperationen. Wenn Sie sofort reagieren möchten, wenn Benutzer auf eine Kontrollkästchenzelle klicken, können Sie das DataGridView.CellContentClick Ereignis behandeln, dieses Ereignis tritt jedoch auf, bevor der Zellwert aktualisiert wird. Wenn Sie zum Zeitpunkt des Klicks den neuen Wert benötigen, gibt es die Möglichkeit zu berechnen, was der erwartete Wert basierend auf dem aktuellen Wert sein wird. Ein weiterer Ansatz besteht darin, die Änderung sofort zu übernehmen und das DataGridView.CellValueChanged Ereignis zu behandeln, um darauf zu reagieren. Um die Änderung zu übernehmen, wenn auf die Zelle geklickt wird, müssen Sie das DataGridView.CurrentCellDirtyStateChanged Ereignis behandeln. Wenn die aktuelle Zelle eine Kontrollkästchenzelle ist, rufen Sie die DataGridView.CommitEdit-Methode auf und übergeben Sie den Commit-Wert.

Hinweise für Vererber

Wenn Sie von der abgeleiteten Klasse abgeleitete Eigenschaften ableiten DataGridViewCheckBoxColumn und neue Eigenschaften hinzufügen, müssen Sie die Clone() Methode überschreiben, um die neuen Eigenschaften während Klonvorgängen zu kopieren. Sie sollten auch die Methode der Basisklasse Clone() aufrufen, damit die Eigenschaften der Basisklasse in die neue Zelle kopiert werden.

Konstruktoren

Name	Beschreibung
DataGridViewCheckBoxColumn()	Initialisiert eine neue Instanz der DataGridViewCheckBoxColumn Klasse in den Standardzustand.
DataGridViewCheckBoxColumn(Boolean)	Initialisiert eine neue Instanz der DataGridViewCheckBoxColumn Und konfiguriert sie so, dass Kontrollkästchen mit zwei oder drei Zuständen angezeigt werden.

Eigenschaften

Name	Beschreibung
AutoSizeMode	Ruft den Modus ab, um den die Spalte automatisch die Breite anpasst, oder legt den Modus fest. (Geerbt von DataGridViewColumn)
CellTemplate	Ruft die Vorlage ab, die zum Erstellen neuer Zellen verwendet wird, oder legt sie fest.
CellType	Ruft den Laufzeittyp der Zellenvorlage ab. (Geerbt von DataGridViewColumn)
ContextMenuStrip	Ruft ab oder legt das Kontextmenü für die Spalte fest. (Geerbt von DataGridViewColumn)
DataGridView	Ruft das DataGridView diesem Element zugeordnete Steuerelement ab. (Geerbt von DataGridViewElement)
DataPropertyName	Dient zum Abrufen oder Festlegen des Namens der Datenquelleneigenschaft oder Datenbankspalte, an die die DataGridViewColumn Datenquelle gebunden ist. (Geerbt von DataGridViewColumn)
DefaultCellStyle	Ruft die Standardzellenformatvorlage der Spalte ab oder legt sie fest.
DefaultHeaderCellType	Dient zum Abrufen oder Festlegen des Laufzeittyps der Standardkopfzeilenzelle. (Geerbt von DataGridViewBand)
Displayed	Ruft einen Wert ab, der angibt, ob das Band derzeit auf dem Bildschirm angezeigt wird. (Geerbt von DataGridViewBand)
DisplayIndex	Ruft die Anzeigereihenfolge der Spalte relativ zu den aktuell angezeigten Spalten ab oder legt sie fest. (Geerbt von DataGridViewColumn)
DividerWidth	Ruft die Breite der Spaltentrennlinie in Pixel ab oder legt sie fest. (Geerbt von DataGridViewColumn)
FalseValue	Dient zum Abrufen oder Festlegen des zugrunde liegenden Werts, der einem Zellwert entspricht `false`, der als deaktiviertes Kontrollkästchen angezeigt wird.
FillWeight	Dient zum Abrufen oder Festlegen eines Werts, der die Breite der Spalte darstellt, wenn sie sich im Füllmodus relativ zu den Breiten anderer Füllmodusspalten im Steuerelement befindet. (Geerbt von DataGridViewColumn)
FlatStyle	Ruft die darstellung der Kontrollkästchenzellen ab oder legt sie fest.
Frozen	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob eine Spalte verschoben wird, wenn ein Benutzer das DataGridView Steuerelement horizontal scrollt. (Geerbt von DataGridViewColumn)
HasDefaultCellStyle	Ruft einen Wert ab, der angibt, ob die DefaultCellStyle Eigenschaft festgelegt wurde. (Geerbt von DataGridViewBand)
HeaderCell	Dient zum Abrufen oder Festlegen des Werts, der DataGridViewColumnHeaderCell die Spaltenüberschrift darstellt. (Geerbt von DataGridViewColumn)
HeaderCellCore	Ruft die Kopfzeilenzelle der DataGridViewBand. (Geerbt von DataGridViewBand)
HeaderText	Dient zum Abrufen oder Festlegen des Beschriftungstexts in der Kopfzeilenzelle der Spalte. (Geerbt von DataGridViewColumn)
IndeterminateValue	Dient zum Abrufen oder Festlegen des zugrunde liegenden Werts, der einem unbestimmten oder `null` Zellwert entspricht, der als deaktiviertes Kontrollkästchen angezeigt wird.
Index	Ruft die relative Position des Bereichs innerhalb des DataGridView Steuerelements ab. (Geerbt von DataGridViewBand)
InheritedAutoSizeMode	Ruft den Größenmodus für die Spalte ab. (Geerbt von DataGridViewColumn)
InheritedStyle	Ruft die aktuell auf die Spalte angewendete Zellenformatvorlage ab. (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 Mindestbreite der Spalte in Pixeln ab oder legt sie fest. (Geerbt von DataGridViewColumn)
Name	Dient zum Abrufen oder Festlegen des Namens der Spalte. (Geerbt von DataGridViewColumn)
ReadOnly	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der Benutzer die Zellen der Spalte bearbeiten kann. (Geerbt von DataGridViewColumn)
Resizable	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Größe der Spalte geändert werden kann. (Geerbt von DataGridViewColumn)
Selected	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob sich das Band in einem ausgewählten Benutzeroberflächenzustand befindet. (Geerbt von DataGridViewBand)
Site	Dient zum Abrufen oder Festlegen der Website der Spalte. (Geerbt von DataGridViewColumn)
SortMode	Dient zum Abrufen oder Festlegen des Sortiermodus für die Spalte. (Geerbt von DataGridViewColumn)
State	Ruft den Benutzeroberflächenstatus des Elements ab. (Geerbt von DataGridViewElement)
Tag	Dient zum Abrufen oder Festlegen des Objekts, das Daten enthält, die dem Band zugeordnet werden sollen. (Geerbt von DataGridViewBand)
ThreeState	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die gehosteten Kontrollkästchenzellen drei Kontrollkästchenzustände statt zwei zulassen.
ToolTipText	Dient zum Abrufen oder Festlegen des Texts, der für QuickInfos verwendet wird. (Geerbt von DataGridViewColumn)
TrueValue	Dient zum Abrufen oder Festlegen des zugrunde liegenden Werts, der einem Zellwert entspricht `true`, der als aktiviertes Feld angezeigt wird.
ValueType	Dient zum Abrufen oder Festlegen des Datentyps der Werte in den Zellen der Spalte. (Geerbt von DataGridViewColumn)
Visible	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Spalte sichtbar ist. (Geerbt von DataGridViewColumn)
Width	Ruft die aktuelle Breite der Spalte ab oder legt sie fest. (Geerbt von DataGridViewColumn)

Methoden

Name	Beschreibung
Clone()	Erstellt eine genaue Kopie dieses Bandes. (Geerbt von DataGridViewColumn)
Dispose()	Veröffentlicht alle ressourcen, die von der DataGridViewBand. (Geerbt von DataGridViewBand)
Dispose(Boolean)	Gibt die nicht verwalteten Ressourcen frei, die von den DataGridViewBand verwalteten Ressourcen verwendet werden, und gibt optional die verwalteten Ressourcen frei. (Geerbt von DataGridViewColumn)
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Dient als Standardhashfunktion. (Geerbt von Object)
GetPreferredWidth(DataGridViewAutoSizeColumnMode, Boolean)	Berechnet die ideale Breite der Spalte basierend auf den angegebenen Kriterien. (Geerbt von DataGridViewColumn)
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
OnDataGridViewChanged()	Wird aufgerufen, wenn das Band einem anderen DataGridViewzugeordnet ist. (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

Name	Beschreibung
Disposed	Tritt auf, wenn der DataGridViewColumn Verworfen wird. (Geerbt von DataGridViewColumn)

Gilt für:

Weitere Informationen

Feedback

War diese Seite hilfreich?