.NET TIPS DataGridコントロールのキャプション表示をカスタマイズするには？ デジタルアドバンテージ 2004/06/18

　DataGridコントロールでは、次の画面のようにコントロール上部にキャプション（＝タイトル）を表示できる。

DataGridコントロールに表示できるキャプション

コントロール上部にキャプション（＝タイトル）を表示できる。DataGridコントロールでは、キャプション・テキストが設定できるだけでなく、フォントの色／サイズ／背景色を設定してキャプション表示を自由にカスタマイズすることが可能だ。

　DataGridコントロールのキャプションは、実はデフォルトで表示されるようになっている。そのため、そこに表示される文字列をキャプション・テキストとして設定すればよい。設定は非常に簡単で、DataGridコントロールのCaptionTextプロパティに文字列を設定するだけである。上の画面の例では、CaptionTextプロパティに「DataGridキャプション」という文字列を設定している。

キャプション・テキストのカスタマイズ

　また、キャプションのテキスト色／背景色／フォントの種類とサイズも併せて設定すれば、キャプション表示も自由にカスタマイズできる。実際に上の画面の例では、テキスト色に「青色」、背景色に「水色」、フォントに「ＭＳ 明朝」「18pt（ポイント）」を設定してキャプション表示をカスタマイズしている。

　テキスト色を設定するには、DataGridコントロールのCaptionForeColorプロパティに、Color構造体（System.Drawing名前空間）の値で色を指定すればよい。また背景色を設定するには、DataGridコントロールのCaptionBackColorプロパティに、同じようにColor構造体の値を指定すればよい。

　フォントの種類とサイズを設定するには、フォントの種類（例えば「ＭＳ 明朝」）とフォントのサイズ（例えば「18pt」）を指定してFontクラス（System.Drawing名前空間）のインスタンスを生成し、そのインスタンスをCaptionFontプロパティに割り当てればよい。

キャプション付きDataGridコントロールを表示するサンプル・プログラム

　以上のキャプション設定をプログラムに実装したのが、次のサンプル・コードだ。

private void Form1_Load(object sender, System.EventArgs e) {   // DataGridのキャプションをカスタマイズ   dataGrid1.CaptionText = "DataGridキャプション";   dataGrid1.CaptionForeColor = Color.FromArgb(0, 0, 255);   dataGrid1.CaptionBackColor = Color.FromArgb(120, 255, 255);   dataGrid1.CaptionFont = new Font("ＭＳ 明朝", 18.0F); }

キャプション表示をカスタマイズするサンプル・コード（C#版）

サンプル・コードを含むプログラム（dgcaption.cs）のダウンロード

　

Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load   ' DataGridのキャプションをカスタマイズ   dataGrid1.CaptionText = "DataGridキャプション"   dataGrid1.CaptionForeColor = Color.FromArgb(0, 0, 255)   dataGrid1.CaptionBackColor = Color.FromArgb(120, 255, 255)   dataGrid1.CaptionFont = New Font("ＭＳ 明朝", 18.0F) End Sub

キャプション表示をカスタマイズするサンプル・コード（VB.NET版）

サンプル・コードを含むプログラム（dgcaption.vb）のダウンロード

　上のコード例では、テキスト色と背景色を設定するために、Color.FromArgbメソッドを使ってRGB（赤、緑、青）形式で色を指定してColor構造体の値を作成し、CaptionForeColorプロパティやCaptionBackColorプロパティに設定している。

　また、フォントの種類とサイズを設定するために、Fontクラスのインスタンスを生成し、そのインスタンスをCaptionFontプロパティに割り当てている。Fontクラスのコンストラクタでは、第1パラメータにフォントの種類「ＭＳ 明朝」を、第2パラメータにフォント・サイズ「18.0F」を指定している

　なお、コード中の「18.0F」の「F」はデータ型を明示するためのサフィックスである（サフィックスの詳細は「TIPS：数値のデータ型を明示的に指定するには？」を参照していただきたい）。

DataGridコントロールのキャプションを完全に非表示にするには？

　このようにDataGridコントロールのキャプション表示は自由にカスタマイズできるが、次の画面のようにキャプションを完全に隠して非表示にすることもできる。

キャプションを非表示にしたDataGridコントロール

DataGridコントロールでは、キャプションを完全に非表示にすることも可能だ。

　これを行うには、DataGridコントロールのCaptionVisibleプロパティにfalseを指定するだけである。

カテゴリ：Windowsフォーム　処理対象：DataGridコントロール 使用ライブラリ：DataGridコントロール 使用ライブラリ：Color構造体（System.Drawing名前空間） 使用ライブラリ：Fontクラス（System.Drawing名前空間） 関連TIPS：数値のデータ型を明示的に指定するには？

　

この記事と関連性の高い別の.NET TIPS DataGridコントロールで入力中のセルをハイライト表示するには？ ［ASP.NET］DataGridコントロールの各セルにアクセスするには？ DataGridコントロールで1行おきに色付けするには？ ［ASP.NET］DataGridコントロールでマウスのある行を強調表示するには？ コンソール・アプリケーションで文字色や背景色を変えるには？ このリストは、（株）デジタルアドバンテージが開発した 自動関連記事探索システム Jigsaw（ジグソー） により自動抽出したものです。 generated by

「.NET TIPS」

＠ITメールマガジン　新着情報やスタッフのコラムがメールで届きます（無料）