DataGridView.ColumnHeadersDefaultCellStyle プロパティ

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

DataGridView.ColumnHeadersDefaultCellStyle プロパティ

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

既定の列ヘッダーのスタイルを取得または設定します。

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

Visual Basic (宣言)

Public Property ColumnHeadersDefaultCellStyle
 As DataGridViewCellStyle

Visual Basic (使用法)

Dim instance As DataGridView
Dim value As DataGridViewCellStyle

value = instance.ColumnHeadersDefaultCellStyle

instance.ColumnHeadersDefaultCellStyle = value

C#

public DataGridViewCellStyle ColumnHeadersDefaultCellStyle { get;
 set; }

C++

public:
property DataGridViewCellStyle^ ColumnHeadersDefaultCellStyle {
    DataGridViewCellStyle^ get ();
    void set (DataGridViewCellStyle^ value);
}

J#

/** @property */
public DataGridViewCellStyle get_ColumnHeadersDefaultCellStyle
 ()

/** @property */
public void set_ColumnHeadersDefaultCellStyle
 (DataGridViewCellStyle value)

JScript

public function get ColumnHeadersDefaultCellStyle
 () : DataGridViewCellStyle

public function set ColumnHeadersDefaultCellStyle
 (value : DataGridViewCellStyle)

プロパティ値
既定の列ヘッダー スタイルを表す DataGridViewCellStyle。

解説

このプロパティによって返される既定の DataGridViewCellStyle には、次の初期プロパティ値が設定されています。

DataGridViewCellStyle プロパティ	既定値
BackColor	SystemBrushes.Control プロパティの値。
ForeColor	SystemBrushes.WindowText プロパティの値。
SelectionBackColor	SystemBrushes.Highlight プロパティの値。
SelectionForeColor	SystemBrushes.HighlightText プロパティの値。
Font	Font プロパティの値。
Alignment	DataGridViewContentAlignment.MiddleLeft
WrapMode	DataGridViewTriState.True

これらの値は、DefaultCellStyle プロパティによって設定された値を自動的にオーバーライドします。列ヘッダーに DefaultCellStyle 値を強制的に継承させるには、ColumnHeadersDefaultCellStyle オブジェクトの値を、DataGridViewCellStyle クラスに対して指定された既定値に設定する必要があります。

セル スタイル継承の詳細については、「Windows フォーム DataGridView コントロールでのセルのスタイル」を参照してください。

使用例

ColumnHeadersDefaultCellStyle、AutoSizeRowsMode、ColumnHeadersBorderStyle、CellBorderStyle、GridColor、BackgroundColor、RowHeadersVisible、SelectionMode、ColumnCount、MultiSelect の各プロパティを設定する方法を次のコード例に示します。さらに、DataGridViewColumn.Name プロパティおよび DataGridViewColumn.DefaultCellStyle プロパティを設定する方法をコード例に示します。この例を実行するには、dataGridView1 という名前の DataGridView が配置されているフォームにコードを貼り付け、フォームのコンストラクタまたは Load イベント ハンドラから SetUpDataGridView メソッドを呼び出します。必ずすべてのイベントをイベント ハンドラに関連付けるようにしてください。

Visual Basic

Private Sub SetUpDataGridView()

    Me.Controls.Add(dataGridView1)
    dataGridView1.ColumnCount = 5

    With dataGridView1.ColumnHeadersDefaultCellStyle
        .BackColor = Color.Navy
        .ForeColor = Color.White
        .Font = New Font(dataGridView1.Font, FontStyle.Bold)
    End With

    With dataGridView1
        .EditMode = DataGridViewEditMode.EditOnEnter
        .Name = "dataGridView1"
        .Location = New Point(8, 8)
        .Size = New Size(500, 300)
        .AutoSizeRowsMode = _
            DataGridViewAutoSizeRowsMode.DisplayedCellsExceptHeaders
        .ColumnHeadersBorderStyle = _
            DataGridViewHeaderBorderStyle.Raised
        .CellBorderStyle = _
            DataGridViewCellBorderStyle.Single
        .GridColor = SystemColors.ActiveBorder
        .RowHeadersVisible = False

        .Columns(0).Name = "Release Date"
        .Columns(1).Name = "Track"
        .Columns(1).DefaultCellStyle.Alignment = DataGridViewContentAlignment.MiddleCenter
        .Columns(2).Name = "Title"
        .Columns(3).Name = "Artist"
        .Columns(4).Name = "Album"

        ' Make the font italic for row four.
        .Columns(4).DefaultCellStyle.Font = _
            New Font(Control.DefaultFont, _
                FontStyle.Italic)

        .SelectionMode = _
            DataGridViewSelectionMode.FullRowSelect
        .MultiSelect = False

        .BackgroundColor = Color.Honeydew

        .Dock = DockStyle.Fill
    End With

End Sub

C#

private void SetUpDataGridView()
{
    this.Controls.Add(dataGridView1);
    dataGridView1.ColumnCount = 5;
    DataGridViewCellStyle style = 
        dataGridView1.ColumnHeadersDefaultCellStyle;
    style.BackColor = Color.Navy;
    style.ForeColor = Color.White;
    style.Font = new Font(dataGridView1.Font, FontStyle.Bold);

    dataGridView1.EditMode = DataGridViewEditMode.EditOnEnter;
    dataGridView1.Name = "dataGridView1";
    dataGridView1.Location = new Point(8, 8);
    dataGridView1.Size = new Size(500, 300);
    dataGridView1.AutoSizeRowsMode = 
        DataGridViewAutoSizeRowsMode.DisplayedCellsExceptHeaders;
    dataGridView1.ColumnHeadersBorderStyle = 
        DataGridViewHeaderBorderStyle.Raised;
    dataGridView1.CellBorderStyle = DataGridViewCellBorderStyle.Single;
    dataGridView1.GridColor = SystemColors.ActiveBorder;
    dataGridView1.RowHeadersVisible = false;

    dataGridView1.Columns[0].Name = "Release Date";
    dataGridView1.Columns[1].Name = "Track";
    dataGridView1.Columns[1].DefaultCellStyle.Alignment = 
        DataGridViewContentAlignment.MiddleCenter;
    dataGridView1.Columns[2].Name = "Title";
    dataGridView1.Columns[3].Name = "Artist";
    dataGridView1.Columns[4].Name = "Album";

    // Make the font italic for row four.
    dataGridView1.Columns[4].DefaultCellStyle.Font = new Font(DataGridView.DefaultFont,
 FontStyle.Italic);

    dataGridView1.SelectionMode = DataGridViewSelectionMode.FullRowSelect;
    dataGridView1.MultiSelect = false;

    dataGridView1.BackgroundColor = Color.Honeydew;

    dataGridView1.Dock = DockStyle.Fill;

    dataGridView1.CellFormatting += new DataGridViewCellFormattingEventHandler(dataGridView1_CellFormatting);
    dataGridView1.CellParsing += new DataGridViewCellParsingEventHandler(dataGridView1_CellParsing);
    addNewRowButton.Click += new EventHandler(addNewRowButton_Click);
    deleteRowButton.Click += new EventHandler(deleteRowButton_Click);
    ledgerStyleButton.Click += new EventHandler(ledgerStyleButton_Click);
    dataGridView1.CellValidating += new DataGridViewCellValidatingEventHandler(dataGridView1_CellValidating);

}

C++

void SetUpDataGridView()
{
   this->Controls->Add( dataGridView1 );
   dataGridView1->ColumnCount = 5;
   DataGridViewCellStyle^ style = dataGridView1->ColumnHeadersDefaultCellStyle;
   style->BackColor = Color::Navy;
   style->ForeColor = Color::White;
   style->Font = gcnew System::Drawing::Font( dataGridView1->Font,FontStyle::Bold
 );
   dataGridView1->EditMode = DataGridViewEditMode::EditOnEnter;
   dataGridView1->Name = "dataGridView1";
   dataGridView1->Location = Point(8,8);
   dataGridView1->Size = System::Drawing::Size( 500, 300 );
   dataGridView1->AutoSizeRowsMode = DataGridViewAutoSizeRowsMode::DisplayedCellsExceptHeaders;
   dataGridView1->ColumnHeadersBorderStyle = DataGridViewHeaderBorderStyle::Raised;
   dataGridView1->CellBorderStyle = DataGridViewCellBorderStyle::Single;
   dataGridView1->GridColor = SystemColors::ActiveBorder;
   dataGridView1->RowHeadersVisible = false;
   dataGridView1->Columns[ 0 ]->Name = "Release Date";
   dataGridView1->Columns[ 1 ]->Name = "Track";
   dataGridView1->Columns[ 1 ]->DefaultCellStyle->Alignment = DataGridViewContentAlignment::MiddleCenter;
   dataGridView1->Columns[ 2 ]->Name = "Title";
   dataGridView1->Columns[ 3 ]->Name = "Artist";
   dataGridView1->Columns[ 4 ]->Name = "Album";

   // Make the font italic for row four.
   dataGridView1->Columns[ 4 ]->DefaultCellStyle->Font = gcnew System::Drawing::Font(
 DataGridView::DefaultFont,FontStyle::Italic );
   dataGridView1->SelectionMode = DataGridViewSelectionMode::FullRowSelect;
   dataGridView1->MultiSelect = false;
   dataGridView1->BackgroundColor = Color::Honeydew;
   dataGridView1->Dock = DockStyle::Fill;
   dataGridView1->CellFormatting += gcnew DataGridViewCellFormattingEventHandler(
 this, &Form1::dataGridView1_CellFormatting );
   dataGridView1->CellParsing += gcnew DataGridViewCellParsingEventHandler( this,
 &Form1::dataGridView1_CellParsing );
   addNewRowButton->Click += gcnew EventHandler( this, &Form1::addNewRowButton_Click
 );
   deleteRowButton->Click += gcnew EventHandler( this, &Form1::deleteRowButton_Click
 );
   ledgerStyleButton->Click += gcnew EventHandler( this, &Form1::ledgerStyleButton_Click
 );
   dataGridView1->CellValidating += gcnew DataGridViewCellValidatingEventHandler(
 this, &Form1::dataGridView1_CellValidating );
}

プラットフォーム

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 名前空間
DataGridViewCellStyle
その他の技術情報
Windows フォーム DataGridView コントロールでのセルのスタイル
DataGridView コントロール (Windows フォーム)