DataGridViewCell Sınıf

Tanım

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
DataGridViewCell
Türetilmiş
Öznitelikler
Uygulamalar

Ö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.

Şunlara uygulanır

Ayrıca bkz.