Bagikan melalui


DataGridViewCell Kelas

Definisi

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
DataGridViewCell
Turunan
Atribut
Penerapan

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.

Berlaku untuk

Lihat juga