DataGridViewCheckBoxColumn Klasa

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Hostuje kolekcję DataGridViewCheckBoxCell obiektów.

public ref 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")>]
type DataGridViewCheckBoxColumn = class
    inherit DataGridViewColumn

Public Class DataGridViewCheckBoxColumn
Inherits DataGridViewColumn

Dziedziczenie

Object

DataGridViewElement

DataGridViewBand

DataGridViewColumn

DataGridViewCheckBoxColumn

Atrybuty

ToolboxBitmapAttribute

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)

Zobacz też

• DataGridView
• DataGridViewColumn
• DataGridViewRow
• DataGridViewCheckBoxCell
• CheckBox
• SortMode
• CellClick
• CellValueChanged
• CurrentCellDirtyStateChanged
• CommitEdit(DataGridViewDataErrorContexts)