DataGridViewCell Sınıf
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
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 IDisposablePublic MustInherit Class DataGridViewCell
Inherits DataGridViewElement
Implements ICloneable, IDisposable- Devralma
- 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. |
