DataGridViewCheckBoxColumn Sınıf

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Kaynak:

DataGridViewCheckBoxColumn.cs

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 kullanılacağını DataGridViewCheckBoxColumn gösterir. Bu örnek, sınıfa genel bakış konusunda sağlanan DataGridViewComboBoxColumn daha büyük bir örneğin 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 özel bir sınıf türüdürDataGridViewColumn. A,kendisiyle DataGridViewCheckBoxColumn kesişen her DataGridViewCheckBoxCell öğeyle ilişkilidirDataGridViewRow. 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 depolanmak veya toplu işlemler gerçekleştirmek amacıyla kullanılır. Kullanıcılar bir onay kutusu hücresine tıkladığında hemen yanıt vermek istiyorsanız, DataGridView.CellContentClick olayını işleyebilirsiniz, 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 DataGridView.CellValueChanged olayını işlemektir. Hücreye tıklandığında değişikliği işlemek için DataGridView.CurrentCellDirtyStateChanged olayını işlemeniz gerekir. İşleyicide, geçerli hücre bir onay kutusu hücresiyse, DataGridView.CommitEdit yöntemini çağırın ve Commit değerini geçirin.

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

Name	Description
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

Name	Description
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ütunun 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ısının genişliğini piksel cinsinden alır veya ayarlar. (Devralındığı yer: DataGridViewColumn)
FalseValue	İşaretsiz 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ğer 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 üst bilgisini 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 resim yazısı metnini 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	Bandın denetim içindeki DataGridView göreli konumunu alır. (Devralındığı yer: DataGridViewBand)
InheritedAutoSizeMode	Sütun için boyutlandırma modunun geçerli olduğunu gösterir. (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ı gösteren 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 durumunun 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

Name	Description
Clone()	Bu bandın tam bir kopyasını oluşturur. (Devralındığı yer: DataGridViewColumn)
Dispose()	tarafından DataGridViewBandkullanılan tüm kaynakları serbest bırakır. (Devralındığı yer: DataGridViewBand)
Dispose(Boolean)	tarafından DataGridViewBand kullanılan yönetilmeyen kaynakları serbest bırakır ve isteğe bağlı olarak yönetilen kaynakları serbest bırakır. (Devralındığı yer: DataGridViewColumn)
GetPreferredWidth(DataGridViewAutoSizeColumnMode, Boolean)	Belirtilen ölçütlere göre sütunun ideal genişliğini hesaplar. (Devralındığı yer: DataGridViewColumn)
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

Name	Description
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)