DataGridViewCell Sınıf

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Denetimdeki tek bir DataGridView hücreyi temsil eder.

public ref class DataGridViewCell abstract : System::Windows::Forms::DataGridViewElement, ICloneable, IDisposable

[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.DataGridViewCellConverter))]
public abstract class DataGridViewCell : System.Windows.Forms.DataGridViewElement, ICloneable, IDisposable

[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.DataGridViewCellConverter))>]
type DataGridViewCell = class
    inherit DataGridViewElement
    interface ICloneable
    interface IDisposable

Public MustInherit Class DataGridViewCell
Inherits DataGridViewElement
Implements ICloneable, IDisposable

Devralma

Object

DataGridViewElement

DataGridViewCell

Türetilmiş

System.Windows.Forms.DataGridViewButtonCell

System.Windows.Forms.DataGridViewCheckBoxCell

System.Windows.Forms.DataGridViewComboBoxCell

System.Windows.Forms.DataGridViewHeaderCell

System.Windows.Forms.DataGridViewImageCell

System.Windows.Forms.DataGridViewLinkCell

System.Windows.Forms.DataGridViewTextBoxCell

Öznitelikler

TypeConverterAttribute

Uygulamalar

ICloneable IDisposable

Örnekler

Aşağıdaki kod örneği, bu türün kullanımını gösterir. Bu örnek hakkında daha fazla bilgi için bkz. Nasıl yapılır: Windows Forms DataGridView Denetimindeki Tek Tek Hücrelere Araç İpuçları Ekleme.

// Sets the ToolTip text for cells in the Rating column.
void dataGridView1_CellFormatting(Object^ /*sender*/, 
    DataGridViewCellFormattingEventArgs^ e)
{
    if ( (e->ColumnIndex == this->dataGridView1->Columns["Rating"]->Index)
        && e->Value != nullptr )
    {
        DataGridViewCell^ cell = 
            this->dataGridView1->Rows[e->RowIndex]->Cells[e->ColumnIndex];
        if (e->Value->Equals("*"))
        {                
            cell->ToolTipText = "very bad";
        }
        else if (e->Value->Equals("**"))
        {
            cell->ToolTipText = "bad";
        }
        else if (e->Value->Equals("***"))
        {
            cell->ToolTipText = "good";
        }
        else if (e->Value->Equals("****"))
        {
            cell->ToolTipText = "very good";
        }
    }
}

// Sets the ToolTip text for cells in the Rating column.
void dataGridView1_CellFormatting(object sender, 
    DataGridViewCellFormattingEventArgs e)
{
    if ( (e.ColumnIndex == this.dataGridView1.Columns["Rating"].Index)
        && e.Value != null )
    {
        DataGridViewCell cell = 
            this.dataGridView1.Rows[e.RowIndex].Cells[e.ColumnIndex];
        if (e.Value.Equals("*"))
        {                
            cell.ToolTipText = "very bad";
        }
        else if (e.Value.Equals("**"))
        {
            cell.ToolTipText = "bad";
        }
        else if (e.Value.Equals("***"))
        {
            cell.ToolTipText = "good";
        }
        else if (e.Value.Equals("****"))
        {
            cell.ToolTipText = "very good";
        }
    }
}

' Sets the ToolTip text for cells in the Rating column.
Sub dataGridView1_CellFormatting(ByVal sender As Object, _
    ByVal e As DataGridViewCellFormattingEventArgs) _
    Handles dataGridView1.CellFormatting

    If e.ColumnIndex = Me.dataGridView1.Columns("Rating").Index _
        AndAlso (e.Value IsNot Nothing) Then

        With Me.dataGridView1.Rows(e.RowIndex).Cells(e.ColumnIndex)

            If e.Value.Equals("*") Then
                .ToolTipText = "very bad"
            ElseIf e.Value.Equals("**") Then
                .ToolTipText = "bad"
            ElseIf e.Value.Equals("***") Then
                .ToolTipText = "good"
            ElseIf e.Value.Equals("****") Then
                .ToolTipText = "very good"
            End If

        End With

    End If

End Sub

Açıklamalar

sınıfı, DataGridViewCell bir denetimdeki tek bir DataGridView hücreyi temsil eder. Bir koleksiyonu DataGridViewRowaracılığıyla Cells hücreleri alabilirsiniz.

Hücrenin içindeki konumunu DataGridViewtanımlayan satır ve sütunDataGridViewCell. Tipik bir hücre, içinde bulunduğu satıra ve sütuna özgü veriler içerir. Hücre, özelliklerini ayarlayarak ve onunla ilişkili olayları işleyerek çeşitli yollarla özelleştirilebilir.

Uygulayanlara Notlar

öğesinden DataGridViewCell türetdiğinizde ve türetilen 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

DataGridViewCell()

DataGridViewCell sınıfının yeni bir örneğini başlatır.

Özellikler

AccessibilityObject	DataGridViewCell.DataGridViewCellAccessibleObject öğesine atanan öğesini DataGridViewCellalır.
ColumnIndex	Bu hücrenin sütun dizinini alır.
ContentBounds	Hücrenin içerik alanını çevreleyen sınırlayıcı dikdörtgeni alır.
ContextMenuStrip	Hücreyle ilişkili kısayol menüsünü alır veya ayarlar.
DataGridView	DataGridView Bu öğeyle ilişkili denetimi alır. (Devralındığı yer: DataGridViewElement)
DefaultNewRowValue	Yeni kayıtlar için satırdaki bir hücrenin varsayılan değerini alır.
Displayed	Hücrenin şu anda ekranda görüntülenip görüntülenmediğini gösteren bir değer alır.
EditedFormattedValue	Hücrenin düzenleme modunda olup olmadığına ve değerin kaydedilmemiş olmasına bakılmaksızın hücrenin geçerli, biçimlendirilmiş değerini alır.
EditType	Hücrenin barındırılan düzenleme denetiminin türünü alır.
ErrorIconBounds	Hücre için hata simgesinin sınırlarını alır.
ErrorText	Hücreyle ilişkili bir hata koşulunu açıklayan metni alır veya ayarlar.
FormattedValue	Hücrenin değerini görüntüleme için biçimlendirilmiş olarak alır.
FormattedValueType	Hücreyle ilişkili biçimlendirilmiş değerin türünü alır.
Frozen	Hücrenin dondurulup donmadığını belirten bir değer alır.
HasStyle	Özelliğin ayarlanıp ayarlanmadığını Style belirten bir değer alır.
InheritedState	Hücrenin geçerli durumunu, satır ve sütun durumundan devralınmış olarak alır.
InheritedStyle	Hücreye uygulanmış olan stili alır.
IsInEditMode	Bu hücrenin şu anda düzenlenip düzenlenmediğini belirten bir değer alır.
OwningColumn	Bu hücreyi içeren sütunu alır.
OwningRow	Bu hücreyi içeren satırı alır.
PreferredSize	Hücrenin sığabileceği dikdörtgen bir alanın piksel cinsinden boyutunu alır.
ReadOnly	Hücre verilerinin düzenlenip düzenlenemeyeceğini belirten bir değer alır veya ayarlar.
Resizable	Hücrenin yeniden boyutlandırılıp boyutlandırılamayacağını belirten bir değer alır.
RowIndex	Hücrenin üst satırının dizinini alır.
Selected	Hücrenin seçilip seçilmediğini belirten bir değer alır veya ayarlar.
Size	Hücrenin boyutunu alır.
State	öğesinin kullanıcı arabirimi (UI) durumunu alır. (Devralındığı yer: DataGridViewElement)
Style	Hücrenin stilini alır veya ayarlar.
Tag	Hücre hakkında ek veriler içeren nesneyi alır veya ayarlar.
ToolTipText	Bu hücreyle ilişkili Araç İpucu metnini alır veya ayarlar.
Value	Bu hücreyle ilişkili değeri alır veya ayarlar.
ValueType	Hücredeki değerlerin veri türünü alır veya ayarlar.
Visible	Hücrenin gizli bir satırda mı yoksa sütunda mı olduğunu gösteren bir değer alır.

Yöntemler

AdjustCellBorderStyle(DataGridViewAdvancedBorderStyle, DataGridViewAdvancedBorderStyle, Boolean, Boolean, Boolean, Boolean)	Giriş hücresi kenarlık stilini belirtilen ölçütlere göre değiştirir.
BorderWidths(DataGridViewAdvancedBorderStyle)	Tüm hücre kenar boşluklarının genişliklerini temsil eden bir Rectangle döndürür.
ClickUnsharesRow(DataGridViewCellEventArgs)	Hücre tıklatıldığında hücrenin satırının paylaşılmayacağını gösterir.
Clone()	Bu hücrenin tam kopyasını oluşturur.
ContentClickUnsharesRow(DataGridViewCellEventArgs)	Hücrenin içeriğine tıklandığında hücrenin satırının paylaşımının kaldırılıp paylaşılmayacağını gösterir.
ContentDoubleClickUnsharesRow(DataGridViewCellEventArgs)	Hücrenin içeriğine çift tıklandığında hücrenin satırının paylaşılmayacağını gösterir.
CreateAccessibilityInstance()	için DataGridViewCellyeni bir erişilebilir nesne oluşturur.
DetachEditingControl()	hücrenin düzenleme denetimini içinden DataGridViewkaldırır.
Dispose()	DataGridViewCell tarafından kullanılan tüm kaynakları serbest bırakır.
Dispose(Boolean)	DataGridViewCell tarafından kullanılan yönetilmeyen kaynakları serbest bırakır ve yönetilen kaynakları isteğe bağlı olarak serbest bırakır.
DoubleClickUnsharesRow(DataGridViewCellEventArgs)	Hücreye çift tıklandığında hücrenin satırının paylaşılmayacağını gösterir.
EnterUnsharesRow(Int32, Boolean)	Odak hücreye taşınırken üst satırın paylaşımının kaldırılıp paylaşılmayacağını gösterir.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
Finalize()	yönetilmeyen kaynakları serbest bırakır ve çöp toplama tarafından geri kazanılmadan önce DataGridViewCell diğer temizleme işlemlerini gerçekleştirir.
GetClipboardContent(Int32, Boolean, Boolean, Boolean, Boolean, String)	öğesine kopyalanacak Clipboardhücrenin biçimlendirilmiş değerini alır.
GetContentBounds(Graphics, DataGridViewCellStyle, Int32)	Belirtilen Graphics ve hücre stili kullanılarak hesaplanan hücrenin içerik alanını çevreleyen sınırlayıcı dikdörtgeni döndürür.
GetContentBounds(Int32)	Hücre için geçerli olan varsayılan Graphics ve hücre stilini kullanarak hücrenin içerik alanını çevreleyen sınırlayıcı dikdörtgeni döndürür.
GetEditedFormattedValue(Int32, DataGridViewDataErrorContexts)	Hücrenin düzenleme modunda olup olmadığına ve değerin kaydedilmemiş olmasına bakılmaksızın hücrenin geçerli, biçimlendirilmiş değerini döndürür.
GetErrorIconBounds(Graphics, DataGridViewCellStyle, Int32)	Hücrenin hata simgesini (görüntüleniyorsa) kapsayan sınırlayıcı dikdörtgeni döndürür.
GetErrorText(Int32)	Hücrenin hatasını temsil eden bir dize döndürür.
GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts)	Hücrenin değerini görüntüleme için biçimlendirilmiş olarak alır.
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetInheritedContextMenuStrip(Int32)	Geçerli hücre için devralınan kısayol menüsünü alır.
GetInheritedState(Int32)	Hücrenin geçerli durumunu satır ve sütun durumundan devralınmış olarak gösteren bir değer döndürür.
GetInheritedStyle(DataGridViewCellStyle, Int32, Boolean)	Hücreye uygulanan stili alır.
GetPreferredSize(Graphics, DataGridViewCellStyle, Int32, Size)	Hücrenin tercih edilen boyutunu piksel cinsinden hesaplar.
GetSize(Int32)	Hücrenin boyutunu alır.
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
GetValue(Int32)	Hücrenin değerini alır.
InitializeEditingControl(Int32, Object, DataGridViewCellStyle)	Hücreyi düzenlemek için kullanılan denetimi başlatır.
KeyDownUnsharesRow(KeyEventArgs, Int32)	Kullanıcı odak hücredeyken bir tuşa bastığında üst satırın paylaşılmadığını gösterir.
KeyEntersEditMode(KeyEventArgs)	Verilen anahtara göre düzenleme modunun başlatılıp başlatılmaması gerektiğini belirler.
KeyPressUnsharesRow(KeyPressEventArgs, Int32)	Satırdaki bir hücre odaktayken bir tuşa basıldığında satırın paylaşımının kaldırılıp paylaşılmayacağını gösterir.
KeyUpUnsharesRow(KeyEventArgs, Int32)	Kullanıcı, odak hücredeyken bir anahtar serbest bıraktığında üst satırın paylaşılmadığını gösterir.
LeaveUnsharesRow(Int32, Boolean)	Odak satırda bir hücreyi bıraktığında bir satırın paylaşımının kaldırılıp paylaşılmayacağını gösterir.
MeasureTextHeight(Graphics, String, Font, Int32, TextFormatFlags)	Belirtilen özelliklere göre belirtilen metnin piksel cinsinden yüksekliğini alır.
MeasureTextHeight(Graphics, String, Font, Int32, TextFormatFlags, Boolean)	Belirtilen özelliklere göre belirtilen metnin piksel cinsinden yüksekliğini alır. Ayrıca, gerekli genişliğin belirtilen maksimum genişlikten büyük olup olmadığını gösterir.
MeasureTextPreferredSize(Graphics, String, Font, Single, TextFormatFlags)	Belirtilen özelliklere göre belirtilen metnin ideal yüksekliğini ve genişliğini alır.
MeasureTextSize(Graphics, String, Font, TextFormatFlags)	Belirtilen özelliklere göre belirtilen metnin yüksekliğini ve genişliğini alır.
MeasureTextWidth(Graphics, String, Font, Int32, TextFormatFlags)	Belirtilen özelliklere göre belirtilen metnin genişliğini piksel cinsinden alır.
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
MouseClickUnsharesRow(DataGridViewCellMouseEventArgs)	İşaretçi satırdaki bir hücre üzerindeyken kullanıcı fare düğmesine tıklarsa satırın paylaşılmayacağını gösterir.
MouseDoubleClickUnsharesRow(DataGridViewCellMouseEventArgs)	Kullanıcı satırdaki bir hücreye çift tıklarsa satırın paylaşılmayacağını gösterir.
MouseDownUnsharesRow(DataGridViewCellMouseEventArgs)	İşaretçi satırdaki bir hücre üzerindeyken kullanıcı fare düğmesini basılı tuttuğunda satırın paylaşılmayacağını gösterir.
MouseEnterUnsharesRow(Int32)	Fare işaretçisi satırdaki bir hücrenin üzerine geldiğinde satırın paylaşılmayacağını gösterir.
MouseLeaveUnsharesRow(Int32)	Fare işaretçisi satırdan ayrıldığında bir satırın paylaşılmayacağını gösterir.
MouseMoveUnsharesRow(DataGridViewCellMouseEventArgs)	Fare işaretçisi satırdaki bir hücrenin üzerine geldiğinde satırın paylaşılmayacağını gösterir.
MouseUpUnsharesRow(DataGridViewCellMouseEventArgs)	İşaretçi satırdaki bir hücre üzerindeyken kullanıcı fare düğmesini serbest bıraktığında satırın paylaşılmayacağını gösterir.
OnClick(DataGridViewCellEventArgs)	Hücre tıklatıldığında çağrılır.
OnContentClick(DataGridViewCellEventArgs)	Hücrenin içeriğine tıklandığında çağrılır.
OnContentDoubleClick(DataGridViewCellEventArgs)	Hücrenin içeriğine çift tıklandığında çağrılır.
OnDataGridViewChanged()	Hücrenin DataGridView özelliği değiştiğinde çağrılır.
OnDoubleClick(DataGridViewCellEventArgs)	Hücreye çift tıklandığında çağrılır.
OnEnter(Int32, Boolean)	Odak bir hücreye taşınırken çağrılır.
OnKeyDown(KeyEventArgs, Int32)	Odak bir hücredeyken karakter tuşuna basıldığında çağrılır.
OnKeyPress(KeyPressEventArgs, Int32)	Odak bir hücre üzerindeyken bir tuşa basıldığında çağrılır.
OnKeyUp(KeyEventArgs, Int32)	Odak bir hücredeyken karakter tuşu serbest bırakıldığında çağrılır.
OnLeave(Int32, Boolean)	Odak bir hücreden hareket ettiğinde çağrılır.
OnMouseClick(DataGridViewCellMouseEventArgs)	İşaretçi bir hücre üzerindeyken kullanıcı fare düğmesine tıkladığında çağrılır.
OnMouseDoubleClick(DataGridViewCellMouseEventArgs)	İşaretçi bir hücre üzerindeyken kullanıcı fare düğmesine çift tıkladığında çağrılır.
OnMouseDown(DataGridViewCellMouseEventArgs)	İşaretçi bir hücre üzerindeyken kullanıcı fare düğmesini basılı tuttuğunda çağrılır.
OnMouseEnter(Int32)	Fare işaretçisi bir hücrenin üzerine geldiğinde çağrılır.
OnMouseLeave(Int32)	Fare işaretçisi hücreden ayrıldığında çağrılır.
OnMouseMove(DataGridViewCellMouseEventArgs)	Fare işaretçisi bir hücre içinde hareket ettiğinde çağrılır.
OnMouseUp(DataGridViewCellMouseEventArgs)	İşaretçi bir hücre üzerindeyken kullanıcı fare düğmesini serbest bıraktığında çağrılır.
Paint(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Object, Object, String, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle, DataGridViewPaintParts)	Geçerli DataGridViewCellöğesini boyar.
PaintBorder(Graphics, Rectangle, Rectangle, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle)	Geçerli DataGridViewCellöğesinin kenarını boyar.
PaintErrorIcon(Graphics, Rectangle, Rectangle, String)	Geçerli DataGridViewCellöğesinin hata simgesini boyar.
ParseFormattedValue(Object, DataGridViewCellStyle, TypeConverter, TypeConverter)	Görüntülenmek üzere biçimlendirilmiş bir değeri gerçek bir hücre değerine dönüştürür.
PositionEditingControl(Boolean, Boolean, Rectangle, Rectangle, DataGridViewCellStyle, Boolean, Boolean, Boolean, Boolean)	Denetimdeki bir hücre tarafından barındırılan düzenleme denetiminin DataGridView konumunu ve boyutunu ayarlar.
PositionEditingPanel(Rectangle, Rectangle, DataGridViewCellStyle, Boolean, Boolean, Boolean, Boolean)	Hücre tarafından barındırılan düzenleme panelinin konumunu ve boyutunu ayarlar ve düzenleme panelindeki düzenleme denetiminin normal sınırlarını döndürür.
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)
SetValue(Int32, Object)	Hücrenin değerini ayarlar.
ToString()	Geçerli nesneyi açıklayan bir dize döndürür.

Ayrıca bkz.

• DataGridView
• ICloneable
• IDisposable