DataGridViewCell Sınıf

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Kaynak:

DataGridViewCell.cs

Denetimdeki tek bir hücreyi DataGridView temsil eder.

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

[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.DataGridViewCellConverter))]
[System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.Interfaces | System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicParameterlessConstructor)]
public abstract class DataGridViewCell : System.Windows.Forms.DataGridViewElement, ICloneable, IDisposable

[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.DataGridViewCellConverter))>]
[<System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.Interfaces | System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicParameterlessConstructor)>]
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 DynamicallyAccessedMembersAttribute

Uygulamalar

ICloneable IDisposable

Örnekler

Aşağıdaki kod örneğinde bu türün kullanımı gösterilmektedir. Bu örnek hakkında daha fazla bilgi için bkz. H nasıl yapılır: Windows Forms DataGridView Denetiminde 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 denetimdeki tek bir DataGridView hücreyi temsil eder. Bir koleksiyonu Cellsaracılığıyla DataGridViewRow hücreleri alabilirsiniz.

Hücrenin konumundaki DataGridViewCellkonumunu belirlemek için DataGridView satır ve sütun. 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ü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
DataGridViewCell()	DataGridViewCell sınıfının yeni bir örneğini başlatır.

Özellikler

Name	Description
AccessibilityObject	DataGridViewCell.DataGridViewCellAccessibleObject öğesine atananı DataGridViewCellalır.
ColumnIndex	Bu hücre için 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 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 işlenmemiş 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 boyutunu piksel cinsinden 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 olan bir satırda mı yoksa sütunda mı olduğunu gösteren bir değer alır.

Yöntemler

Name	Description
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ücre satırının paylaşılmayacağını gösterir.
Clone()	Bu hücrenin tam kopyasını oluşturur.
ContentClickUnsharesRow(DataGridViewCellEventArgs)	Hücrenin içeriği tıklatıldığında hücre satırının 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()	tarafından DataGridViewCellkullanılan tüm kaynakları serbest bırakır.
Dispose(Boolean)	tarafından DataGridViewCell kullanılan yönetilmeyen kaynakları serbest bırakır ve isteğe bağlı olarak yönetilen kaynakları serbest bırakır.
DoubleClickUnsharesRow(DataGridViewCellEventArgs)	Hücreye çift tıklandığında hücre satırının paylaşımının kaldırılıp 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.
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ı kapsayan 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ı kapsayan sınırlayıcı dikdörtgeni döndürür.
GetEditedFormattedValue(Int32, DataGridViewDataErrorContexts)	Hücrenin düzenleme modunda olup olmamasına ve değerin işlenmemiş olmasına bakılmaksızın hücrenin geçerli, biçimlendirilmiş değerini döndürür.
GetErrorIconBounds(Graphics, DataGridViewCellStyle, Int32)	Görüntülenirse hücrenin hata simgesini çevreleyen 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.
GetInheritedContextMenuStrip(Int32)	Geçerli hücre için devralınan kısayol menüsünü alır.
GetInheritedState(Int32)	Satır ve sütun durumundan devralınan hücrenin geçerli durumunu 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.
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şılmayacağını gösterir.
MeasureTextHeight(Graphics, String, Font, Int32, TextFormatFlags, Boolean)	Belirtilen özelliklere göre belirtilen metnin yüksekliğini piksel cinsinden alır. Ayrıca, gerekli genişliğin belirtilen maksimum genişlikten büyük olup olmadığını gösterir.
MeasureTextHeight(Graphics, String, Font, Int32, TextFormatFlags)	Belirtilen özelliklere göre belirtilen metnin yüksekliğini piksel cinsinden alır.
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.
MouseClickUnsharesRow(DataGridViewCellMouseEventArgs)	kullanıcı, işaretçi satırdaki bir hücrenin üzerindeyken 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)	kullanıcı, işaretçi satırdaki bir hücre üzerindeyken 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 bir satırın paylaşılmayacağını gösterir.
MouseLeaveUnsharesRow(Int32)	Fare işaretçisi satırı terk ettiğinde bir satırın paylaşılmayacağını gösterir.
MouseMoveUnsharesRow(DataGridViewCellMouseEventArgs)	Fare işaretçisi satırdaki bir hücrenin üzerine geldiğinde bir satırın paylaşılmayacağını gösterir.
MouseUpUnsharesRow(DataGridViewCellMouseEventArgs)	Kullanıcı, işaretçi satırdaki bir hücre üzerindeyken fare düğmesini serbest bıraktığında satırın paylaşılmayacağını gösterir.
OnClick(DataGridViewCellEventArgs)	Hücre tıklandığı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ücre üzerindeyken karakter tuşuna basıldığında çağrılır.
OnKeyPress(KeyPressEventArgs, Int32)	Odak bir hücredeyken 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)	kullanıcı işaretçi bir hücrenin üzerindeyken fare düğmesine tıkladığında çağrılır.
OnMouseDoubleClick(DataGridViewCellMouseEventArgs)	kullanıcı, işaretçi bir hücre üzerindeyken fare düğmesine çift tıkladığında çağrılır.
OnMouseDown(DataGridViewCellMouseEventArgs)	kullanıcı, işaretçi bir hücre üzerindeyken fare düğmesini basılı tuttuğunda çağrılır.
OnMouseEnter(Int32)	Fare işaretçisi bir hücrenin üzerinde hareket ettiğ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)	kullanıcı işaretçi bir hücre üzerindeyken 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 DataGridViewCellhata 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 tanımlayan bir dize döndürür.

Ayrıca bkz.

• DataGridView
• ICloneable
• IDisposable