DataGridViewCheckBoxColumn Klas
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Fungeert als host voor een verzameling DataGridViewCheckBoxCell objecten.
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 DataGridViewColumnPublic Class DataGridViewCheckBoxColumn
Inherits DataGridViewColumn- Overname
- Kenmerken
Voorbeelden
In het volgende codevoorbeeld ziet u hoe u een DataGridViewCheckBoxColumn code gebruikt om aan te geven welke werknemers niet op kantoor zijn. Dit voorbeeld maakt deel uit van een groter voorbeeld dat beschikbaar is in het overzichtsonderwerp van de DataGridViewComboBoxColumn klas.
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
Opmerkingen
De DataGridViewCheckBoxColumn klasse is een gespecialiseerd type van de DataGridViewColumn klasse die wordt gebruikt om cellen logisch te hosten die de binaire status aangeven. A DataGridViewCheckBoxColumn heeft een verband in DataGridViewCheckBoxCell elk DataGridViewRow dat het besnijdt. Elke cel levert een gebruikersinterface (UI) die vergelijkbaar is met een CheckBox besturingselement.
De standaardsorteringsmodus voor dit kolomtype is NotSortable.
Normaal gesproken zijn selectievakjecelwaarden bedoeld voor opslag, net als andere gegevens, of voor het uitvoeren van bulkbewerkingen. Als u onmiddellijk wilt reageren wanneer gebruikers op een selectievakjecel klikken, kunt u de DataGridView.CellContentClick gebeurtenis afhandelen, maar deze gebeurtenis vindt plaats voordat de celwaarde wordt bijgewerkt. Als u de nieuwe waarde op het moment van de klik nodig hebt, kunt u met één optie berekenen wat de verwachte waarde is op basis van de huidige waarde. Een andere aanpak is het direct doorvoeren van de wijziging en het afhandelen van de DataGridView.CellValueChanged gebeurtenis om erop te reageren. Als u de wijziging wilt doorvoeren wanneer op de cel wordt geklikt, moet u de gebeurtenis DataGridView.CurrentCellDirtyStateChanged afhandelen. Als de huidige cel in de handler een selectievakjecel is, roept u de methode DataGridView.CommitEdit aan en geeft u de Commit waarde door.
Notities voor overnemers
Wanneer u bent afgeleid van DataGridViewCheckBoxColumn en nieuwe eigenschappen toevoegt aan de afgeleide klasse, moet u de Clone() methode overschrijven om de nieuwe eigenschappen te kopiëren tijdens het klonen. U moet ook de methode van Clone() de basisklasse aanroepen, zodat de eigenschappen van de basisklasse naar de nieuwe cel worden gekopieerd.
Constructors
| Name | Description |
|---|---|
| DataGridViewCheckBoxColumn() |
Initialiseert een nieuw exemplaar van de DataGridViewCheckBoxColumn klasse naar de standaardstatus. |
| DataGridViewCheckBoxColumn(Boolean) |
Initialiseert een nieuw exemplaar van de DataGridViewCheckBoxColumn en configureert deze om selectievakjes met twee of drie statussen weer te geven. |
Eigenschappen
| Name | Description |
|---|---|
| AutoSizeMode |
Hiermee wordt de modus opgehaald of ingesteld waarmee de kolom automatisch de breedte aanpast. (Overgenomen van DataGridViewColumn) |
| CellTemplate |
Hiermee haalt u de sjabloon op die wordt gebruikt om nieuwe cellen te maken of stelt u deze in. |
| CellType |
Hiermee haalt u het runtimetype van de celsjabloon op. (Overgenomen van DataGridViewColumn) |
| ContextMenuStrip |
Hiermee haalt u het snelmenu voor de kolom op of stelt u deze in. (Overgenomen van DataGridViewColumn) |
| DataGridView |
Hiermee haalt u het DataGridView besturingselement op dat aan dit element is gekoppeld. (Overgenomen van DataGridViewElement) |
| DataPropertyName |
Hiermee haalt u de naam op van de gegevensbroneigenschap of databasekolom waaraan de DataGridViewColumn afhankelijke gegevensbron is gekoppeld. (Overgenomen van DataGridViewColumn) |
| DefaultCellStyle |
Hiermee haalt u de standaardcelstijl van de kolom op of stelt u deze in. |
| DefaultHeaderCellType |
Hiermee haalt u het runtimetype van de standaardkopcel op of stelt u deze in. (Overgenomen van DataGridViewBand) |
| Displayed |
Hiermee wordt een waarde opgehaald die aangeeft of de band momenteel op het scherm wordt weergegeven. (Overgenomen van DataGridViewBand) |
| DisplayIndex |
Hiermee wordt de weergavevolgorde van de kolom ten opzichte van de momenteel weergegeven kolommen opgehaald of ingesteld. (Overgenomen van DataGridViewColumn) |
| DividerWidth |
Hiermee haalt u de breedte, in pixels, van de kolomscheiding op of stelt u deze in. (Overgenomen van DataGridViewColumn) |
| FalseValue |
Hiermee wordt de onderliggende waarde opgehaald of ingesteld die overeenkomt met een celwaarde van |
| FillWeight |
Hiermee wordt een waarde opgehaald of ingesteld die de breedte van de kolom aangeeft wanneer deze zich in de vulmodus bevindt ten opzichte van de breedte van andere opvulmoduskolommen in het besturingselement. (Overgenomen van DataGridViewColumn) |
| FlatStyle |
Hiermee haalt u het uiterlijk van de platte stijl van de selectievakjecellen op of stelt u deze in. |
| Frozen |
Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of een kolom wordt verplaatst wanneer een gebruiker het DataGridView besturingselement horizontaal schuift. (Overgenomen van DataGridViewColumn) |
| HasDefaultCellStyle |
Hiermee wordt een waarde opgehaald die aangeeft of de DefaultCellStyle eigenschap is ingesteld. (Overgenomen van DataGridViewBand) |
| HeaderCell |
Hiermee haalt u de kolomkop op of stelt u deze DataGridViewColumnHeaderCell in. (Overgenomen van DataGridViewColumn) |
| HeaderCellCore |
Hiermee haalt u de koptekstcel van de cel op of stelt u deze DataGridViewBandin. (Overgenomen van DataGridViewBand) |
| HeaderText |
Hiermee haalt u de bijschrifttekst op of stelt u deze in op de koptekstcel van de kolom. (Overgenomen van DataGridViewColumn) |
| IndeterminateValue |
Hiermee wordt de onderliggende waarde opgehaald of ingesteld die overeenkomt met een onbepaalde waarde of |
| Index |
Hiermee haalt u de relatieve positie van de band binnen het DataGridView besturingselement op. (Overgenomen van DataGridViewBand) |
| InheritedAutoSizeMode |
Hiermee wordt de groottemodus van kracht voor de kolom. (Overgenomen van DataGridViewColumn) |
| InheritedStyle |
Hiermee haalt u de celstijl op die momenteel op de kolom is toegepast. (Overgenomen van DataGridViewColumn) |
| IsDataBound |
Hiermee wordt een waarde opgehaald die aangeeft of de kolom is gebonden aan een gegevensbron. (Overgenomen van DataGridViewColumn) |
| IsRow |
Hiermee wordt een waarde opgehaald die aangeeft of de band een rij vertegenwoordigt. (Overgenomen van DataGridViewBand) |
| MinimumWidth |
Hiermee haalt u de minimale breedte in pixels van de kolom op of stelt u deze in. (Overgenomen van DataGridViewColumn) |
| Name |
Hiermee haalt u de naam van de kolom op of stelt u deze in. (Overgenomen van DataGridViewColumn) |
| ReadOnly |
Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de gebruiker de cellen van de kolom kan bewerken. (Overgenomen van DataGridViewColumn) |
| Resizable |
Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de kolom kan worden aangepast. (Overgenomen van DataGridViewColumn) |
| Selected |
Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de band de status van een geselecteerde gebruikersinterface heeft. (Overgenomen van DataGridViewBand) |
| Site |
Hiermee haalt u de site van de kolom op of stelt u deze in. (Overgenomen van DataGridViewColumn) |
| SortMode |
Hiermee haalt u de sorteermodus voor de kolom op of stelt u deze in. (Overgenomen van DataGridViewColumn) |
| State |
Hiermee haalt u de gebruikersinterfacestatus (UI) van het element op. (Overgenomen van DataGridViewElement) |
| Tag |
Hiermee wordt het object opgehaald of ingesteld dat gegevens bevat die aan de band moeten worden gekoppeld. (Overgenomen van DataGridViewBand) |
| ThreeState |
Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de gehoste selectievakjecellen drie controlestatussen toestaan in plaats van twee. |
| ToolTipText |
Hiermee haalt u de tekst op die wordt gebruikt voor Knopinfo of stelt u deze in. (Overgenomen van DataGridViewColumn) |
| TrueValue |
Hiermee wordt de onderliggende waarde opgehaald of ingesteld die overeenkomt met een celwaarde van |
| ValueType |
Hiermee wordt het gegevenstype van de waarden in de cellen van de kolom opgehaald of ingesteld. (Overgenomen van DataGridViewColumn) |
| Visible |
Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de kolom zichtbaar is. (Overgenomen van DataGridViewColumn) |
| Width |
Hiermee haalt u de huidige breedte van de kolom op of stelt u deze in. (Overgenomen van DataGridViewColumn) |
Methoden
| Name | Description |
|---|---|
| Clone() |
Hiermee maakt u een exacte kopie van deze band. (Overgenomen van DataGridViewColumn) |
| Dispose() |
Alle resources die worden gebruikt door de DataGridViewBand. (Overgenomen van DataGridViewBand) |
| Dispose(Boolean) |
Publiceert de niet-beheerde resources die worden gebruikt door de DataGridViewBand beheerde resources en brengt eventueel de beheerde resources vrij. (Overgenomen van DataGridViewColumn) |
| Equals(Object) |
Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object) |
| GetHashCode() |
Fungeert als de standaardhashfunctie. (Overgenomen van Object) |
| GetPreferredWidth(DataGridViewAutoSizeColumnMode, Boolean) |
Berekent de ideale breedte van de kolom op basis van de opgegeven criteria. (Overgenomen van DataGridViewColumn) |
| GetType() |
Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object) |
| MemberwiseClone() |
Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object) |
| OnDataGridViewChanged() |
Wordt aangeroepen wanneer de band is gekoppeld aan een andere DataGridView. (Overgenomen van DataGridViewBand) |
| RaiseCellClick(DataGridViewCellEventArgs) |
Hiermee wordt de CellClick gebeurtenis gegenereerd. (Overgenomen van DataGridViewElement) |
| RaiseCellContentClick(DataGridViewCellEventArgs) |
Hiermee wordt de CellContentClick gebeurtenis gegenereerd. (Overgenomen van DataGridViewElement) |
| RaiseCellContentDoubleClick(DataGridViewCellEventArgs) |
Hiermee wordt de CellContentDoubleClick gebeurtenis gegenereerd. (Overgenomen van DataGridViewElement) |
| RaiseCellValueChanged(DataGridViewCellEventArgs) |
Hiermee wordt de CellValueChanged gebeurtenis gegenereerd. (Overgenomen van DataGridViewElement) |
| RaiseDataError(DataGridViewDataErrorEventArgs) |
Hiermee wordt de DataError gebeurtenis gegenereerd. (Overgenomen van DataGridViewElement) |
| RaiseMouseWheel(MouseEventArgs) |
Hiermee wordt de MouseWheel gebeurtenis gegenereerd. (Overgenomen van DataGridViewElement) |
| ToString() |
Hiermee haalt u een tekenreeks op die de kolom beschrijft. |
gebeurtenis
| Name | Description |
|---|---|
| Disposed |
Treedt op wanneer de DataGridViewColumn verwijdering wordt uitgevoerd. (Overgenomen van DataGridViewColumn) |
