DataGridViewCheckBoxColumn Klasa

Definicja

Hostuje kolekcję DataGridViewCheckBoxCell obiektów.

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
Dziedziczenie
Atrybuty

Przykłady

W poniższym przykładzie kodu pokazano, jak używać obiektu , DataGridViewCheckBoxColumn aby oznaczyć pracowników, którzy są poza biurem. Ten przykład jest częścią większego przykładu dostępnego w temacie DataGridViewComboBoxColumn przeglądu klasy.

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

Uwagi

Klasa DataGridViewCheckBoxColumn jest wyspecjalizowanym typem klasy używanej DataGridViewColumn do logicznego hostowania komórek wskazujących stan binarny. Element DataGridViewCheckBoxColumn ma element skojarzony DataGridViewCheckBoxCell w każdym DataGridViewRow , który przecina go. Każda komórka dostarcza interfejs użytkownika podobny do kontrolki CheckBox .

Domyślny tryb sortowania dla tego typu kolumny to NotSortable.

Zazwyczaj wartości komórek pól wyboru są przeznaczone do przechowywania, podobnie jak inne dane, lub do wykonywania operacji zbiorczych. Jeśli chcesz natychmiast odpowiedzieć po kliknięciu komórki pola wyboru przez użytkowników, możesz obsłużyć DataGridView.CellContentClick zdarzenie, ale to zdarzenie występuje przed zaktualizowaną wartością komórki. Jeśli potrzebujesz nowej wartości w momencie kliknięcia, jedną z opcji jest obliczenie oczekiwanej wartości na podstawie bieżącej wartości. Innym podejściem jest natychmiastowe zatwierdzenie zmiany i obsługa zdarzenia w celu reagowania DataGridView.CellValueChanged na nie. Aby zatwierdzić zmianę po kliknięciu komórki, musisz obsłużyć DataGridView.CurrentCellDirtyStateChanged zdarzenie. W procedurze obsługi, jeśli bieżąca komórka jest komórką pola wyboru, wywołaj DataGridView.CommitEdit metodę i przekaż Commit wartość.

Uwagi dotyczące dziedziczenia

Po utworzeniu i DataGridViewCheckBoxColumn dodaniu nowych właściwości do klasy pochodnej pamiętaj, aby zastąpić metodę Clone() , aby skopiować nowe właściwości podczas operacji klonowania. Należy również wywołać metodę klasy Clone() bazowej, aby właściwości klasy bazowej zostały skopiowane do nowej komórki.

Konstruktory

DataGridViewCheckBoxColumn()

Inicjuje DataGridViewCheckBoxColumn nowe wystąpienie klasy do stanu domyślnego.

DataGridViewCheckBoxColumn(Boolean)

Inicjuje nowe wystąpienie obiektu DataGridViewCheckBoxColumn i konfiguruje je do wyświetlania pól wyboru z dwoma lub trzema stanami.

Właściwości

AutoSizeMode

Pobiera lub ustawia tryb automatycznego dostosowywania szerokości kolumny.

(Odziedziczone po DataGridViewColumn)
CellTemplate

Pobiera lub ustawia szablon używany do tworzenia nowych komórek.

CellType

Pobiera typ czasu wykonywania szablonu komórki.

(Odziedziczone po DataGridViewColumn)
ContextMenuStrip

Pobiera lub ustawia menu skrótów dla kolumny.

(Odziedziczone po DataGridViewColumn)
DataGridView

DataGridView Pobiera formant skojarzony z tym elementem.

(Odziedziczone po DataGridViewElement)
DataPropertyName

Pobiera lub ustawia nazwę właściwości źródła danych lub kolumny bazy danych, z którą DataGridViewColumn jest powiązana.

(Odziedziczone po DataGridViewColumn)
DefaultCellStyle

Pobiera lub ustawia domyślny styl komórki kolumny.

DefaultHeaderCellType

Pobiera lub ustawia typ czasu wykonywania domyślnej komórki nagłówka.

(Odziedziczone po DataGridViewBand)
Displayed

Pobiera wartość wskazującą, czy pasek jest obecnie wyświetlany na ekranie.

(Odziedziczone po DataGridViewBand)
DisplayIndex

Pobiera lub ustawia kolejność wyświetlania kolumny względem aktualnie wyświetlanych kolumn.

(Odziedziczone po DataGridViewColumn)
DividerWidth

Pobiera lub ustawia szerokość dzielenia kolumn w pikselach.

(Odziedziczone po DataGridViewColumn)
FalseValue

Pobiera lub ustawia wartość bazową odpowiadającą wartości komórki , falsektóra jest wyświetlana jako niezaznaczone pole.

FillWeight

Pobiera lub ustawia wartość reprezentującą szerokość kolumny, gdy jest w trybie wypełnienia względem szerokości innych kolumn trybu wypełnienia w kontrolce.

(Odziedziczone po DataGridViewColumn)
FlatStyle

Pobiera lub ustawia płaski wygląd stylu komórek pola wyboru.

Frozen

Pobiera lub ustawia wartość wskazującą, czy kolumna zostanie przeniesiona, gdy użytkownik przewija kontrolkę DataGridView w poziomie.

(Odziedziczone po DataGridViewColumn)
HasDefaultCellStyle

Pobiera wartość wskazującą DefaultCellStyle , czy właściwość została ustawiona.

(Odziedziczone po DataGridViewBand)
HeaderCell

Pobiera lub ustawia nagłówek DataGridViewColumnHeaderCell kolumny, który reprezentuje nagłówek kolumny.

(Odziedziczone po DataGridViewColumn)
HeaderCellCore

Pobiera lub ustawia komórkę nagłówka obiektu DataGridViewBand.

(Odziedziczone po DataGridViewBand)
HeaderText

Pobiera lub ustawia podpis tekst w komórce nagłówka kolumny.

(Odziedziczone po DataGridViewColumn)
IndeterminateValue

Pobiera lub ustawia wartość bazową odpowiadającą nieokreślonej lub null wartości komórki, która jest wyświetlana jako wyłączone pole wyboru.

Index

Pobiera względną pozycję pasma w kontrolce DataGridView .

(Odziedziczone po DataGridViewBand)
InheritedAutoSizeMode

Pobiera tryb określania rozmiaru w kolumnie.

(Odziedziczone po DataGridViewColumn)
InheritedStyle

Pobiera styl komórki aktualnie zastosowany do kolumny.

(Odziedziczone po DataGridViewColumn)
IsDataBound

Pobiera wartość wskazującą, czy kolumna jest powiązana ze źródłem danych.

(Odziedziczone po DataGridViewColumn)
IsRow

Pobiera wartość wskazującą, czy przedział reprezentuje wiersz.

(Odziedziczone po DataGridViewBand)
MinimumWidth

Pobiera lub ustawia minimalną szerokość kolumny w pikselach.

(Odziedziczone po DataGridViewColumn)
Name

Pobiera lub ustawia nazwę kolumny.

(Odziedziczone po DataGridViewColumn)
ReadOnly

Pobiera lub ustawia wartość wskazującą, czy użytkownik może edytować komórki kolumny.

(Odziedziczone po DataGridViewColumn)
Resizable

Pobiera lub ustawia wartość wskazującą, czy kolumna ma możliwość zmiany rozmiaru.

(Odziedziczone po DataGridViewColumn)
Selected

Pobiera lub ustawia wartość wskazującą, czy przedział jest w stanie wybranego interfejsu użytkownika.

(Odziedziczone po DataGridViewBand)
Site

Pobiera lub ustawia lokację kolumny.

(Odziedziczone po DataGridViewColumn)
SortMode

Pobiera lub ustawia tryb sortowania dla kolumny.

(Odziedziczone po DataGridViewColumn)
State

Pobiera stan interfejsu użytkownika elementu.

(Odziedziczone po DataGridViewElement)
Tag

Pobiera lub ustawia obiekt zawierający dane do skojarzenia z pasmem.

(Odziedziczone po DataGridViewBand)
ThreeState

Pobiera lub ustawia wartość wskazującą, czy hostowane komórki pola wyboru będą zezwalać na trzy stany kontrolne, a nie dwa.

ToolTipText

Pobiera lub ustawia tekst używany dla etykietek narzędzi.

(Odziedziczone po DataGridViewColumn)
TrueValue

Pobiera lub ustawia wartość bazową odpowiadającą wartości komórki , truektóra jest wyświetlana jako pole wyboru.

ValueType

Pobiera lub ustawia typ danych wartości w komórkach kolumny.

(Odziedziczone po DataGridViewColumn)
Visible

Pobiera lub ustawia wartość wskazującą, czy kolumna jest widoczna.

(Odziedziczone po DataGridViewColumn)
Width

Pobiera lub ustawia bieżącą szerokość kolumny.

(Odziedziczone po DataGridViewColumn)

Metody

Clone()

Tworzy dokładną kopię tego pasma.

(Odziedziczone po DataGridViewColumn)
Dispose()

Zwalnia wszelkie zasoby używane przez element DataGridViewBand.

(Odziedziczone po DataGridViewBand)
Dispose(Boolean)

Zwalnia zasoby niezarządzane używane przez element DataGridViewBand i opcjonalnie zwalnia zasoby zarządzane.

(Odziedziczone po DataGridViewColumn)
Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.

(Odziedziczone po Object)
GetHashCode()

Służy jako domyślna funkcja skrótu.

(Odziedziczone po Object)
GetPreferredWidth(DataGridViewAutoSizeColumnMode, Boolean)

Oblicza idealną szerokość kolumny na podstawie określonych kryteriów.

(Odziedziczone po DataGridViewColumn)
GetType()

Type Pobiera wartość bieżącego wystąpienia.

(Odziedziczone po Object)
MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
OnDataGridViewChanged()

Wywoływana, gdy zespół jest skojarzony z innym DataGridViewelementem .

(Odziedziczone po DataGridViewBand)
RaiseCellClick(DataGridViewCellEventArgs)

CellClick Zgłasza zdarzenie.

(Odziedziczone po DataGridViewElement)
RaiseCellContentClick(DataGridViewCellEventArgs)

CellContentClick Zgłasza zdarzenie.

(Odziedziczone po DataGridViewElement)
RaiseCellContentDoubleClick(DataGridViewCellEventArgs)

CellContentDoubleClick Zgłasza zdarzenie.

(Odziedziczone po DataGridViewElement)
RaiseCellValueChanged(DataGridViewCellEventArgs)

CellValueChanged Zgłasza zdarzenie.

(Odziedziczone po DataGridViewElement)
RaiseDataError(DataGridViewDataErrorEventArgs)

DataError Zgłasza zdarzenie.

(Odziedziczone po DataGridViewElement)
RaiseMouseWheel(MouseEventArgs)

MouseWheel Zgłasza zdarzenie.

(Odziedziczone po DataGridViewElement)
ToString()

Pobiera ciąg opisujący kolumnę.

Zdarzenia

Disposed

Występuje, gdy element DataGridViewColumn jest usuwany.

(Odziedziczone po DataGridViewColumn)

Dotyczy

Zobacz też