DataGridViewCell Kelas

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Mewakili sel individual dalam DataGridView kontrol.

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

Warisan

Object

DataGridViewElement

DataGridViewCell

Turunan

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

Atribut

TypeConverterAttribute

Penerapan

ICloneable IDisposable

Contoh

Contoh kode berikut mengilustrasikan penggunaan jenis ini. Untuk informasi selengkapnya tentang contoh ini, lihat Cara: Menambahkan TipsAlat ke Sel Individual dalam Kontrol DataGridView Formulir Windows.

// 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

Keterangan

Kelas DataGridViewCell mewakili sel individual dalam DataGridView kontrol. Anda dapat mengambil sel melalui Cells koleksi DataGridViewRow.

Baris dan kolom untuk DataGridViewCell mengidentifikasi lokasi sel di DataGridView. Sel biasa berisi data khusus untuk baris dan kolom tempat sel tersebut berada. Sel dapat dikustomisasi dalam sejumlah cara dengan mengatur propertinya dan menangani peristiwa yang terkait dengannya.

Catatan Bagi Implementer

Ketika Anda berasal dari DataGridViewCell dan menambahkan properti baru ke kelas turunan, pastikan untuk mengambil alih Clone() metode untuk menyalin properti baru selama operasi kloning. Anda juga harus memanggil metode kelas Clone() dasar sehingga properti kelas dasar disalin ke sel baru.

Konstruktor

DataGridViewCell()

Menginisialisasi instans baru kelas DataGridViewCell.

Properti

AccessibilityObject	Mendapatkan yang DataGridViewCell.DataGridViewCellAccessibleObject ditetapkan ke DataGridViewCell.
ColumnIndex	Mendapatkan indeks kolom untuk sel ini.
ContentBounds	Mendapatkan persegi panjang pembatas yang mengapit area konten sel.
ContextMenuStrip	Mendapatkan atau mengatur menu pintasan yang terkait dengan sel.
DataGridView	Mendapatkan kontrol yang DataGridView terkait dengan elemen ini. (Diperoleh dari DataGridViewElement)
DefaultNewRowValue	Mendapatkan nilai default untuk sel dalam baris untuk rekaman baru.
Displayed	Mendapatkan nilai yang menunjukkan apakah sel saat ini ditampilkan di layar.
EditedFormattedValue	Mendapatkan nilai sel yang saat ini diformat, terlepas dari apakah sel berada dalam mode edit dan nilai belum diterapkan.
EditType	Mendapatkan jenis kontrol pengeditan sel yang dihosting.
ErrorIconBounds	Mendapatkan batas ikon kesalahan untuk sel.
ErrorText	Mendapatkan atau mengatur teks yang menjelaskan kondisi kesalahan yang terkait dengan sel.
FormattedValue	Mendapatkan nilai sel seperti yang diformat untuk ditampilkan.
FormattedValueType	Mendapatkan tipe nilai yang diformat yang terkait dengan sel.
Frozen	Mendapatkan nilai yang menunjukkan apakah sel dibekukan.
HasStyle	Mendapatkan nilai yang menunjukkan apakah Style properti telah ditetapkan.
InheritedState	Mendapatkan status sel saat ini seperti yang diwarisi dari status baris dan kolomnya.
InheritedStyle	Mendapatkan gaya yang saat ini diterapkan ke sel.
IsInEditMode	Mendapatkan nilai yang menunjukkan apakah sel ini sedang diedit.
OwningColumn	Mendapatkan kolom yang berisi sel ini.
OwningRow	Mendapatkan baris yang berisi sel ini.
PreferredSize	Mendapatkan ukuran, dalam piksel, dari area persegi panjang tempat sel dapat pas.
ReadOnly	Mendapatkan atau mengatur nilai yang menunjukkan apakah data sel dapat diedit.
Resizable	Mendapatkan nilai yang menunjukkan apakah sel dapat diubah ukurannya.
RowIndex	Mendapatkan indeks baris induk sel.
Selected	Mendapatkan atau mengatur nilai yang menunjukkan apakah sel telah dipilih.
Size	Mendapatkan ukuran sel.
State	Mendapatkan status antarmuka pengguna (UI) dari elemen . (Diperoleh dari DataGridViewElement)
Style	Mendapatkan atau mengatur gaya untuk sel.
Tag	Mendapatkan atau mengatur objek yang berisi data tambahan tentang sel.
ToolTipText	Mendapatkan atau mengatur teks TipsAlat yang terkait dengan sel ini.
Value	Mendapatkan atau mengatur nilai yang terkait dengan sel ini.
ValueType	Mendapatkan atau mengatur tipe data nilai dalam sel.
Visible	Mendapatkan nilai yang menunjukkan apakah sel berada dalam baris atau kolom yang telah disembunyikan.

Metode

AdjustCellBorderStyle(DataGridViewAdvancedBorderStyle, DataGridViewAdvancedBorderStyle, Boolean, Boolean, Boolean, Boolean)	Memodifikasi gaya batas sel input sesuai dengan kriteria yang ditentukan.
BorderWidths(DataGridViewAdvancedBorderStyle)	Mengembalikan yang Rectangle menunjukkan lebar semua margin sel.
ClickUnsharesRow(DataGridViewCellEventArgs)	Menunjukkan apakah baris sel akan tidak dibagikan saat sel diklik.
Clone()	Membuat salinan sel ini dengan tepat.
ContentClickUnsharesRow(DataGridViewCellEventArgs)	Menunjukkan apakah baris sel akan tidak dibagikan saat konten sel diklik.
ContentDoubleClickUnsharesRow(DataGridViewCellEventArgs)	Menunjukkan apakah baris sel akan tidak dibagikan saat konten sel diklik ganda.
CreateAccessibilityInstance()	Membuat objek baru yang dapat diakses untuk DataGridViewCell.
DetachEditingControl()	Menghapus kontrol pengeditan sel dari DataGridView.
Dispose()	Merilis semua sumber daya yang DataGridViewCelldigunakan oleh .
Dispose(Boolean)	Merilis sumber daya tidak terkelola yang digunakan oleh DataGridViewCell dan secara opsional merilis sumber daya terkelola.
DoubleClickUnsharesRow(DataGridViewCellEventArgs)	Menunjukkan apakah baris sel akan tidak dibagikan saat sel diklik ganda.
EnterUnsharesRow(Int32, Boolean)	Menunjukkan apakah baris induk akan tidak dibagikan saat fokus berpindah ke sel.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
Finalize()	Merilis sumber daya yang tidak dikelola dan melakukan operasi pembersihan lainnya sebelum DataGridViewCell direklamasi oleh pengumpulan sampah.
GetClipboardContent(Int32, Boolean, Boolean, Boolean, Boolean, String)	Mengambil nilai sel yang diformat untuk disalin ke Clipboard.
GetContentBounds(Graphics, DataGridViewCellStyle, Int32)	Mengembalikan persegi panjang pembatas yang mengapit area konten sel, yang dihitung menggunakan gaya sel dan yang ditentukan Graphics .
GetContentBounds(Int32)	Mengembalikan persegi panjang pembatas yang mengapit area konten sel menggunakan default Graphics dan gaya sel yang saat ini berlaku untuk sel.
GetEditedFormattedValue(Int32, DataGridViewDataErrorContexts)	Mengembalikan nilai sel yang saat ini diformat, terlepas dari apakah sel berada dalam mode edit dan nilai belum diterapkan.
GetErrorIconBounds(Graphics, DataGridViewCellStyle, Int32)	Mengembalikan persegi panjang pembatas yang mengapit ikon kesalahan sel, jika ditampilkan.
GetErrorText(Int32)	Mengembalikan string yang menunjukkan kesalahan untuk sel.
GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts)	Mendapatkan nilai sel seperti yang diformat untuk ditampilkan.
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetInheritedContextMenuStrip(Int32)	Mendapatkan menu pintasan yang diwariskan untuk sel saat ini.
GetInheritedState(Int32)	Mengembalikan nilai yang menunjukkan status sel saat ini sebagaimana diwarisi dari status baris dan kolomnya.
GetInheritedStyle(DataGridViewCellStyle, Int32, Boolean)	Mendapatkan gaya yang diterapkan ke sel.
GetPreferredSize(Graphics, DataGridViewCellStyle, Int32, Size)	Menghitung ukuran pilihan, dalam piksel, dari sel.
GetSize(Int32)	Mendapatkan ukuran sel.
GetType()	Mendapatkan dari instans Type saat ini. (Diperoleh dari Object)
GetValue(Int32)	Mendapatkan nilai sel.
InitializeEditingControl(Int32, Object, DataGridViewCellStyle)	Menginisialisasi kontrol yang digunakan untuk mengedit sel.
KeyDownUnsharesRow(KeyEventArgs, Int32)	Menunjukkan apakah baris induk tidak dibagikan jika pengguna menekan tombol saat fokus berada pada sel.
KeyEntersEditMode(KeyEventArgs)	Menentukan apakah mode edit harus dimulai berdasarkan kunci yang diberikan.
KeyPressUnsharesRow(KeyPressEventArgs, Int32)	Menunjukkan apakah baris akan tidak dibagikan jika tombol ditekan saat sel di baris memiliki fokus.
KeyUpUnsharesRow(KeyEventArgs, Int32)	Menunjukkan apakah baris induk tidak dibagikan saat pengguna merilis kunci saat fokus berada pada sel.
LeaveUnsharesRow(Int32, Boolean)	Menunjukkan apakah baris akan tidak dibagikan saat fokus meninggalkan sel dalam baris.
MeasureTextHeight(Graphics, String, Font, Int32, TextFormatFlags)	Mendapatkan tinggi, dalam piksel, dari teks yang ditentukan, mengingat karakteristik yang ditentukan.
MeasureTextHeight(Graphics, String, Font, Int32, TextFormatFlags, Boolean)	Mendapatkan tinggi, dalam piksel, dari teks yang ditentukan, mengingat karakteristik yang ditentukan. Juga menunjukkan apakah lebar yang diperlukan lebih besar dari lebar maksimum yang ditentukan.
MeasureTextPreferredSize(Graphics, String, Font, Single, TextFormatFlags)	Mendapatkan tinggi dan lebar ideal dari teks yang ditentukan mengingat karakteristik yang ditentukan.
MeasureTextSize(Graphics, String, Font, TextFormatFlags)	Mendapatkan tinggi dan lebar teks yang ditentukan mengingat karakteristik yang ditentukan.
MeasureTextWidth(Graphics, String, Font, Int32, TextFormatFlags)	Mendapatkan lebar, dalam piksel, dari teks yang ditentukan mengingat karakteristik yang ditentukan.
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
MouseClickUnsharesRow(DataGridViewCellMouseEventArgs)	Menunjukkan apakah baris akan tidak dibagikan jika pengguna mengklik tombol mouse saat penunjuk berada di sel dalam baris.
MouseDoubleClickUnsharesRow(DataGridViewCellMouseEventArgs)	Menunjukkan apakah baris akan tidak dibagikan jika pengguna mengklik dua kali sel dalam baris.
MouseDownUnsharesRow(DataGridViewCellMouseEventArgs)	Menunjukkan apakah baris akan tidak dibagikan saat pengguna menahan tombol mouse saat penunjuk berada di sel dalam baris.
MouseEnterUnsharesRow(Int32)	Menunjukkan apakah baris akan tidak dibagikan saat penunjuk mouse bergerak di atas sel dalam baris.
MouseLeaveUnsharesRow(Int32)	Menunjukkan apakah baris akan tidak dibagikan saat penunjuk mouse meninggalkan baris.
MouseMoveUnsharesRow(DataGridViewCellMouseEventArgs)	Menunjukkan apakah baris akan tidak dibagikan saat penunjuk mouse bergerak di atas sel dalam baris.
MouseUpUnsharesRow(DataGridViewCellMouseEventArgs)	Menunjukkan apakah baris akan tidak dibagikan saat pengguna melepaskan tombol mouse saat penunjuk berada di sel dalam baris.
OnClick(DataGridViewCellEventArgs)	Dipanggil saat sel diklik.
OnContentClick(DataGridViewCellEventArgs)	Dipanggil saat konten sel diklik.
OnContentDoubleClick(DataGridViewCellEventArgs)	Dipanggil saat konten sel diklik dua kali.
OnDataGridViewChanged()	Dipanggil DataGridView saat properti sel berubah.
OnDoubleClick(DataGridViewCellEventArgs)	Dipanggil saat sel diklik ganda.
OnEnter(Int32, Boolean)	Dipanggil saat fokus berpindah ke sel.
OnKeyDown(KeyEventArgs, Int32)	Dipanggil saat tombol karakter ditekan saat fokus berada pada sel.
OnKeyPress(KeyPressEventArgs, Int32)	Dipanggil saat tombol ditekan saat fokus berada pada sel.
OnKeyUp(KeyEventArgs, Int32)	Dipanggil saat kunci karakter dilepaskan saat fokus berada pada sel.
OnLeave(Int32, Boolean)	Dipanggil saat fokus berpindah dari sel.
OnMouseClick(DataGridViewCellMouseEventArgs)	Dipanggil saat pengguna mengklik tombol mouse saat penunjuk berada di sel.
OnMouseDoubleClick(DataGridViewCellMouseEventArgs)	Dipanggil saat pengguna mengklik dua kali tombol mouse saat penunjuk berada di sel.
OnMouseDown(DataGridViewCellMouseEventArgs)	Dipanggil saat pengguna menahan tombol mouse saat penunjuk berada di sel.
OnMouseEnter(Int32)	Dipanggil saat penunjuk mouse bergerak di atas sel.
OnMouseLeave(Int32)	Dipanggil saat penunjuk mouse meninggalkan sel.
OnMouseMove(DataGridViewCellMouseEventArgs)	Dipanggil saat penunjuk mouse bergerak di dalam sel.
OnMouseUp(DataGridViewCellMouseEventArgs)	Dipanggil saat pengguna melepaskan tombol mouse saat penunjuk berada di sel.
Paint(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Object, Object, String, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle, DataGridViewPaintParts)	Melukis saat ini DataGridViewCell.
PaintBorder(Graphics, Rectangle, Rectangle, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle)	Melukis batas arus DataGridViewCell.
PaintErrorIcon(Graphics, Rectangle, Rectangle, String)	Melukis ikon kesalahan dari saat ini DataGridViewCell.
ParseFormattedValue(Object, DataGridViewCellStyle, TypeConverter, TypeConverter)	Mengonversi nilai yang diformat untuk ditampilkan ke nilai sel aktual.
PositionEditingControl(Boolean, Boolean, Rectangle, Rectangle, DataGridViewCellStyle, Boolean, Boolean, Boolean, Boolean)	Mengatur lokasi dan ukuran kontrol pengeditan yang dihosting oleh sel dalam DataGridView kontrol.
PositionEditingPanel(Rectangle, Rectangle, DataGridViewCellStyle, Boolean, Boolean, Boolean, Boolean)	Mengatur lokasi dan ukuran panel pengeditan yang dihosting oleh sel, dan mengembalikan batas normal kontrol pengeditan dalam panel pengeditan.
RaiseCellClick(DataGridViewCellEventArgs)	Memunculkan kejadian CellClick. (Diperoleh dari DataGridViewElement)
RaiseCellContentClick(DataGridViewCellEventArgs)	Memunculkan kejadian CellContentClick. (Diperoleh dari DataGridViewElement)
RaiseCellContentDoubleClick(DataGridViewCellEventArgs)	Memunculkan kejadian CellContentDoubleClick. (Diperoleh dari DataGridViewElement)
RaiseCellValueChanged(DataGridViewCellEventArgs)	Memunculkan kejadian CellValueChanged. (Diperoleh dari DataGridViewElement)
RaiseDataError(DataGridViewDataErrorEventArgs)	Memunculkan kejadian DataError. (Diperoleh dari DataGridViewElement)
RaiseMouseWheel(MouseEventArgs)	Memunculkan kejadian MouseWheel. (Diperoleh dari DataGridViewElement)
SetValue(Int32, Object)	Mengatur nilai sel.
ToString()	Mengembalikan string yang menjelaskan objek saat ini.

Lihat juga

• DataGridView
• ICloneable
• IDisposable