DataGridView.RowTemplate Properti

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Sumber:

DataGridView.cs

Mendapatkan atau mengatur baris yang mewakili templat untuk semua baris dalam kontrol.

public:
 property System::Windows::Forms::DataGridViewRow ^ RowTemplate { System::Windows::Forms::DataGridViewRow ^ get(); void set(System::Windows::Forms::DataGridViewRow ^ value); };

[System.ComponentModel.Browsable(true)]
public System.Windows.Forms.DataGridViewRow RowTemplate { get; set; }

[<System.ComponentModel.Browsable(true)>]
member this.RowTemplate : System.Windows.Forms.DataGridViewRow with get, set

Public Property RowTemplate As DataGridViewRow

Nilai Properti

DataGridViewRow

mewakili DataGridViewRow templat baris.

Atribut

BrowsableAttribute

Pengecualian

InvalidOperationException

Baris yang ditentukan saat mengatur properti ini memiliki kumpulan propertinya DataGridView .

Contoh

Contoh kode berikut mengilustrasikan cara menggunakan templat baris untuk menentukan tinggi baris awal dan tinggi baris minimum.

DataGridViewRow^ row = this->dataGridView1->RowTemplate;
row->DefaultCellStyle->BackColor = Color::Bisque;
row->Height = 35;
row->MinimumHeight = 20;

DataGridViewRow row = this.dataGridView1.RowTemplate;
row.DefaultCellStyle.BackColor = Color.Bisque;
row.Height = 35;
row.MinimumHeight = 20;

With Me.dataGridView1.RowTemplate
    .DefaultCellStyle.BackColor = Color.Bisque
    .Height = 35
    .MinimumHeight = 20
End With

Keterangan

Terkadang Anda menginginkan kontrol yang lebih besar atas tampilan DataGridView baris daripada apa yang disediakan oleh berbagai DataGridView properti gaya sel. Properti RowTemplate memungkinkan Anda membuat dan menginisialisasi DataGridViewRow untuk digunakan sebagai templat oleh semua baris, termasuk baris untuk rekaman baru jika AllowUserToAddRows adalah true.

Ini berguna saat Anda mengatur nilai default untuk properti seperti tinggi baris. Misalnya, Anda mungkin ingin meningkatkan tinggi baris default untuk menyediakan ruang tambahan di bawah konten sel biasa untuk menampilkan konten yang mencakup beberapa kolom.

Mengatur templat baris diperlukan saat data eksternal ditampilkan menggunakan jenis kustom yang berasal dari DataGridViewRow kelas . Dengan kontrol yang tidak terikat DataGridView , Anda dapat mengisi Rows koleksi secara terprogram dengan instans jenis baris kustom Anda. Namun, saat menampilkan data eksternal, baris dihasilkan secara otomatis, tetapi didasarkan pada templat baris, yang dapat Anda atur ke instans jenis baris kustom Anda.

Jika properti ini belum diatur saat pertama kali Anda mengambil nilainya, baru DataGridViewRow dibuat dan dikembalikan.

Lihat juga

• Kontrol DataGridView (Formulir Windows)