DataGridView.RowTemplate プロパティ

定義

コントロール内のすべての行のテンプレートを表す行を取得または設定します。

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

プロパティ値

行テンプレートを表す DataGridViewRow

属性

例外

このプロパティの設定時に指定された行には、DataGridView プロパティが設定されています。

次のコード例は、行テンプレートを使用して、最初の行の高さと最小行の高さを指定する方法を示しています。

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

注釈

場合によっては、さまざまなDataGridViewセル スタイルプロパティによって提供されるよりも、行のDataGridView外観をより大きく制御する必要があります。 RowTemplateプロパティを使用すると、 が の場合AllowUserToAddRowstrueは、新しいレコードの行を含め、すべての行でテンプレートとして使用する を作成および初期化DataGridViewRowできます。

これは、行の高さなどのプロパティの既定値を設定する場合に便利です。 たとえば、複数の列にまたがるコンテンツを表示するために、通常のセル コンテンツの下に余分なスペースを確保するために、既定の行の高さを増やしたい場合があります。

クラスから派生したカスタム型を使用して外部データを表示する場合は、行テンプレートを設定する DataGridViewRow 必要があります。 バインド DataGridView されていないコントロールを使用すると、カスタム行の種類のインスタンスを Rows コレクションにプログラムで設定できます。 ただし、外部データを表示する場合、行は自動的に生成されますが、行テンプレートに基づいており、カスタム行の種類のインスタンスに設定できます。

このプロパティの値を初めて取得するときにこのプロパティが設定されていない場合は、新 DataGridViewRow しい が作成されて返されます。

適用対象

こちらもご覧ください