DataGridViewCheckBoxColumn Sınıf

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Bir nesne koleksiyonunu barındırıyor DataGridViewCheckBoxCell .

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

Devralma

Object

DataGridViewElement

DataGridViewBand

DataGridViewColumn

DataGridViewCheckBoxColumn

Öznitelikler

ToolboxBitmapAttribute

Örnekler

Aşağıdaki kod örneği, hangi çalışanların iş yeri dışında olduğunu işaretlemek için nasıl DataGridViewCheckBoxColumn kullanılacağını gösterir. Bu örnek, sınıfa genel bakış konusunda bulunan DataGridViewComboBoxColumn daha büyük bir örneğin bir parçasıdır.

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

Açıklamalar

DataGridViewCheckBoxColumn sınıfı, ikili durumu gösteren hücreleri mantıksal olarak barındırmak için kullanılan sınıfın özelleştirilmiş bir türüdürDataGridViewColumn. A DataGridViewCheckBoxColumn ile kesişen her DataGridViewRow ile ilişkilendirilmiş DataGridViewCheckBoxCell bir vardır. Her hücre, denetime CheckBox benzer bir kullanıcı arabirimi (UI) sağlar.

Bu sütun türü için varsayılan sıralama modu şeklindedir NotSortable.

Genellikle, onay kutusu hücre değerleri diğer veriler gibi depolamaya veya toplu işlemler gerçekleştirmeye yöneliktir. Kullanıcılar bir onay kutusu hücresine tıkladığında hemen yanıt vermek istiyorsanız, olayı işleyebilirsiniz DataGridView.CellContentClick , ancak bu olay hücre değeri güncelleştirilmeden önce gerçekleşir. Tıklama sırasında yeni değere ihtiyacınız varsa, bir seçenek beklenen değerin geçerli değere göre hesaplanmasıdır. Bir diğer yaklaşım da değişikliği hemen işlemek ve buna yanıt vermek için olayı işlemektir DataGridView.CellValueChanged . Hücreye tıklandığında değişikliği işlemek için olayı işlemeniz DataGridView.CurrentCellDirtyStateChanged gerekir. İşleyicide, geçerli hücre bir onay kutusu hücresiyse yöntemini çağırın DataGridView.CommitEdit ve değerini geçirin Commit .

Devralanlara Notlar

öğesinden DataGridViewCheckBoxColumn türetdiğinizde ve türetilmiş sınıfa yeni özellikler eklediğinizde, kopyalama işlemleri sırasında yeni özellikleri kopyalamak için yöntemini geçersiz kıldığınızdan Clone() emin olun. Temel sınıfın Clone() özelliklerinin yeni hücreye kopyalanmaları için temel sınıfın yöntemini de çağırmalısınız.

Oluşturucular

DataGridViewCheckBoxColumn()	Sınıfın DataGridViewCheckBoxColumn yeni bir örneğini varsayılan duruma başlatır.
DataGridViewCheckBoxColumn(Boolean)	öğesinin DataGridViewCheckBoxColumn yeni bir örneğini başlatır ve iki veya üç durumlu onay kutularını görüntüleyecek şekilde yapılandırır.

Özellikler

AutoSizeMode	Sütunun genişliğini otomatik olarak ayarladığı modu alır veya ayarlar. (Devralındığı yer: DataGridViewColumn)
CellTemplate	Yeni hücre oluşturmak için kullanılan şablonu alır veya ayarlar.
CellType	Hücre şablonunun çalışma zamanı türünü alır. (Devralındığı yer: DataGridViewColumn)
ContextMenuStrip	Sütun için kısayol menüsünü alır veya ayarlar. (Devralındığı yer: DataGridViewColumn)
DataGridView	DataGridView Bu öğeyle ilişkili denetimi alır. (Devralındığı yer: DataGridViewElement)
DataPropertyName	bağlı olduğu veri kaynağı özelliğinin veya veritabanı sütununun DataGridViewColumn adını alır veya ayarlar. (Devralındığı yer: DataGridViewColumn)
DefaultCellStyle	Sütunun varsayılan hücre stilini alır veya ayarlar.
DefaultHeaderCellType	Varsayılan üst bilgi hücresinin çalışma zamanı türünü alır veya ayarlar. (Devralındığı yer: DataGridViewBand)
Displayed	Bandın şu anda ekranda görüntülenip görüntülenmediğini gösteren bir değer alır. (Devralındığı yer: DataGridViewBand)
DisplayIndex	Sütunun görüntülenme sırasını o anda görüntülenen sütunlara göre alır veya ayarlar. (Devralındığı yer: DataGridViewColumn)
DividerWidth	Sütun ayırıcının genişliğini piksel cinsinden alır veya ayarlar. (Devralındığı yer: DataGridViewColumn)
FalseValue	İşaretsiz bir kutu olarak görünen hücre değerine karşılık gelen temel değeri falsealır veya ayarlar.
FillWeight	Denetimdeki diğer dolgu modu sütunlarının genişliklerine göre doldurma modundayken sütunun genişliğini temsil eden bir değeri alır veya ayarlar. (Devralındığı yer: DataGridViewColumn)
FlatStyle	Onay kutusu hücrelerinin düz stil görünümünü alır veya ayarlar.
Frozen	Kullanıcı denetimi yatay olarak kaydırdığında sütunun DataGridView taşınıp taşınmayacağını belirten bir değer alır veya ayarlar. (Devralındığı yer: DataGridViewColumn)
HasDefaultCellStyle	Özelliğin ayarlanıp ayarlanmadığını DefaultCellStyle belirten bir değer alır. (Devralındığı yer: DataGridViewBand)
HeaderCell	Sütun başlığını temsil eden öğesini alır veya ayarlar DataGridViewColumnHeaderCell . (Devralındığı yer: DataGridViewColumn)
HeaderCellCore	öğesinin üst bilgi hücresini DataGridViewBandalır veya ayarlar. (Devralındığı yer: DataGridViewBand)
HeaderText	Sütunun üst bilgi hücresindeki başlık metni alır veya ayarlar. (Devralındığı yer: DataGridViewColumn)
IndeterminateValue	Devre dışı bırakılmış onay kutusu olarak görünen belirsiz veya hücre değerine karşılık gelen temel değeri alır veya null ayarlar.
Index	Denetimin içindeki DataGridView bandın göreli konumunu alır. (Devralındığı yer: DataGridViewBand)
InheritedAutoSizeMode	Sütun için boyutlandırma modunu etkin hale alır. (Devralındığı yer: DataGridViewColumn)
InheritedStyle	Şu anda sütuna uygulanan hücre stilini alır. (Devralındığı yer: DataGridViewColumn)
IsDataBound	Sütunun bir veri kaynağına bağlı olup olmadığını belirten bir değer alır. (Devralındığı yer: DataGridViewColumn)
IsRow	Bandın bir satırı temsil edip etmediğini gösteren bir değer alır. (Devralındığı yer: DataGridViewBand)
MinimumWidth	Sütunun piksel cinsinden en düşük genişliğini alır veya ayarlar. (Devralındığı yer: DataGridViewColumn)
Name	Sütunun adını alır veya ayarlar. (Devralındığı yer: DataGridViewColumn)
ReadOnly	Kullanıcının sütunun hücrelerini düzenleyip düzenleyemeyeceğini belirten bir değer alır veya ayarlar. (Devralındığı yer: DataGridViewColumn)
Resizable	Sütunun yeniden boyutlandırılabilir olup olmadığını belirten bir değer alır veya ayarlar. (Devralındığı yer: DataGridViewColumn)
Selected	Bandın seçili kullanıcı arabirimi (UI) durumunda olup olmadığını belirten bir değer alır veya ayarlar. (Devralındığı yer: DataGridViewBand)
Site	Sütunun sitesini alır veya ayarlar. (Devralındığı yer: DataGridViewColumn)
SortMode	Sütun için sıralama modunu alır veya ayarlar. (Devralındığı yer: DataGridViewColumn)
State	öğesinin kullanıcı arabirimi (UI) durumunu alır. (Devralındığı yer: DataGridViewElement)
Tag	Bantla ilişkilendirilecek verileri içeren nesneyi alır veya ayarlar. (Devralındığı yer: DataGridViewBand)
ThreeState	Barındırılan onay kutusu hücrelerinin iki yerine üç onay durumuna izin verip vermeyeceğini belirten bir değer alır veya ayarlar.
ToolTipText	Araç İpuçları için kullanılan metni alır veya ayarlar. (Devralındığı yer: DataGridViewColumn)
TrueValue	İşaretli kutu olarak görünen hücre değerine karşılık gelen temel değeri truealır veya ayarlar.
ValueType	Sütunun hücrelerindeki değerlerin veri türünü alır veya ayarlar. (Devralındığı yer: DataGridViewColumn)
Visible	Sütunun görünür olup olmadığını belirten bir değer alır veya ayarlar. (Devralındığı yer: DataGridViewColumn)
Width	Sütunun geçerli genişliğini alır veya ayarlar. (Devralındığı yer: DataGridViewColumn)

Yöntemler

Clone()	Bu bandın tam bir kopyasını oluşturur. (Devralındığı yer: DataGridViewColumn)
Dispose()	DataGridViewBand tarafından kullanılan tüm kaynakları serbest bırakır. (Devralındığı yer: DataGridViewBand)
Dispose(Boolean)	DataGridViewBand tarafından kullanılan yönetilmeyen kaynakları serbest bırakır ve yönetilen kaynakları isteğe bağlı olarak serbest bırakır. (Devralındığı yer: DataGridViewColumn)
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetPreferredWidth(DataGridViewAutoSizeColumnMode, Boolean)	Belirtilen ölçütlere göre sütunun ideal genişliğini hesaplar. (Devralındığı yer: DataGridViewColumn)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
OnDataGridViewChanged()	Bant farklı DataGridViewbir ile ilişkilendirildiğinde çağrılır. (Devralındığı yer: DataGridViewBand)
RaiseCellClick(DataGridViewCellEventArgs)	Olayı tetikler CellClick . (Devralındığı yer: DataGridViewElement)
RaiseCellContentClick(DataGridViewCellEventArgs)	Olayı tetikler CellContentClick . (Devralındığı yer: DataGridViewElement)
RaiseCellContentDoubleClick(DataGridViewCellEventArgs)	Olayı tetikler CellContentDoubleClick . (Devralındığı yer: DataGridViewElement)
RaiseCellValueChanged(DataGridViewCellEventArgs)	Olayı tetikler CellValueChanged . (Devralındığı yer: DataGridViewElement)
RaiseDataError(DataGridViewDataErrorEventArgs)	Olayı tetikler DataError . (Devralındığı yer: DataGridViewElement)
RaiseMouseWheel(MouseEventArgs)	Olayı tetikler MouseWheel . (Devralındığı yer: DataGridViewElement)
ToString()	Sütunu açıklayan bir dize alır.

Ekinlikler

Disposed

atıldığında DataGridViewColumn gerçekleşir. (Devralındığı yer: DataGridViewColumn)

Ayrıca bkz.

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