Freigeben über


DataGridViewCheckBoxColumn Klasse

Definition

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

Weitere Informationen