DataGridView.RowTemplate プロパティ

.NET Framework クラス ライブラリ リファレンス

DataGridView.RowTemplate プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

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

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Property RowTemplate As
 DataGridViewRow

Visual Basic (使用法)

Dim instance As DataGridView
Dim value As DataGridViewRow

value = instance.RowTemplate

instance.RowTemplate = value

C#

public DataGridViewRow RowTemplate { get; set;
 }

C++

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

J#

/** @property */
public DataGridViewRow get_RowTemplate ()

/** @property */
public void set_RowTemplate (DataGridViewRow
 value)

JScript

public function get RowTemplate
 () : DataGridViewRow

public function set RowTemplate
 (value : DataGridViewRow)

プロパティ値
行テンプレートを表す DataGridViewRow。

例外

例外の種類	条件
InvalidOperationException	このプロパティの設定時に指定された値には、DataGridView プロパティが設定されています。

解説

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

これは、行の高さなどのプロパティに既定値を設定する場合に便利です。たとえば、複数の列にまたがる内容を表示するために、通常のセルの内容の下に空白ができるように、既定の行を高くできます。

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

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

使用例

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

Visual Basic

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

C#

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

C++

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
DataGridView クラス
DataGridView メンバ
System.Windows.Forms 名前空間
その他の技術情報
DataGridView コントロール (Windows フォーム)