DataGridTableStyle.AlternatingBackColor プロパティ

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

DataGridTableStyle.AlternatingBackColor プロパティ

グリッドの奇数行の背景色を取得または設定します。

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

Visual Basic (宣言)

Public Property AlternatingBackColor As
 Color

Visual Basic (使用法)

Dim instance As DataGridTableStyle
Dim value As Color

value = instance.AlternatingBackColor

instance.AlternatingBackColor = value

C#

public Color AlternatingBackColor { get; set;
 }

C++

public:
property Color AlternatingBackColor {
    Color get ();
    void set (Color value);
}

J#

/** @property */
public Color get_AlternatingBackColor ()

/** @property */
public void set_AlternatingBackColor (Color
 value)

JScript

public function get AlternatingBackColor
 () : Color

public function set AlternatingBackColor
 (value : Color)

プロパティ値
奇数行の背景色を表す Color。既定値は Window です。

使用例

DataGridTableStyle のインスタンスを作成し、BackColor プロパティおよび AlternatingBackColor プロパティに新しい値を設定するコード例を次に示します。この例は、データを格納する System.Data.DataSet を持つ DataGrid および Button が、Form 上にあることを前提としています。

Visual Basic

Private Sub AddCustomDataTableStyle()
   myDataGridTableStyle1 = New DataGridTableStyle()

   ' EventHandlers
   AddHandler myDataGridTableStyle1.GridLineColorChanged, AddressOf
 GridLineColorChanged_Handler
   myDataGridTableStyle1.MappingName = "Customers"

   ' Set other properties.
   myDataGridTableStyle1.AlternatingBackColor = System.Drawing.Color.Gold
   myDataGridTableStyle1.BackColor = System.Drawing.Color.White
   myDataGridTableStyle1.GridLineStyle = System.Windows.Forms.DataGridLineStyle.Solid
   myDataGridTableStyle1.GridLineColor = Color.Red

   ' Set the HeaderText and Width properties.
   Dim myBoolCol = New DataGridBoolColumn()
   myBoolCol.MappingName = "Current"
   myBoolCol.HeaderText = "IsCurrent Customer"
   myBoolCol.Width = 150
   myDataGridTableStyle1.GridColumnStyles.Add(myBoolCol)

   ' Add a second column style.
   Dim myTextCol = New DataGridTextBoxColumn()
   myTextCol.MappingName = "custName"
   myTextCol.HeaderText = "Customer Name"
   myTextCol.Width = 250
   myDataGridTableStyle1.GridColumnStyles.Add(myTextCol)

   ' Create new ColumnStyle objects
   Dim cOrderDate = New DataGridTextBoxColumn()
   cOrderDate.MappingName = "OrderDate"
   cOrderDate.HeaderText = "Order Date"
   cOrderDate.Width = 100

   ' Use a PropertyDescriptor to create a formatted column.
   Dim myPropertyDescriptorCollection As PropertyDescriptorCollection
 = _
                  BindingContext(myDataSet, "Customers.custToOrders").GetItemProperties()

   ' Create a formatted column using a PropertyDescriptor.
   Dim csOrderAmount = New DataGridTextBoxColumn(myPropertyDescriptorCollection(
 _
                                                "OrderAmount"),
 "c", True)
   csOrderAmount.MappingName = "OrderAmount"
   csOrderAmount.HeaderText = "Total"
   csOrderAmount.Width = 100

   ' Add the DataGridTableStyle instances to the GridTableStylesCollection.
   myDataGrid.TableStyles.Add(myDataGridTableStyle1)
End Sub 'AddCustomDataTableStyle

Private Sub GridLineColorChanged_Handler(ByVal
 sender As Object, ByVal
 e As EventArgs)
   MessageBox.Show("GridLineColor Changed", "DataGridTableStyle")
End Sub 'GridLineColorChanged_Handler

C#

private void AddCustomDataTableStyle()
{
   myDataGridTableStyle1 = new DataGridTableStyle();
  
   // EventHandlers          
   myDataGridTableStyle1.GridLineColorChanged += new System.EventHandler(GridLineColorChanged_Handler);
         
   myDataGridTableStyle1.MappingName = "Customers";

   // Set other properties.
   myDataGridTableStyle1.AlternatingBackColor=System.Drawing.Color.Gold;
   myDataGridTableStyle1.BackColor = System.Drawing.Color.White;
   myDataGridTableStyle1.GridLineStyle=System.Windows.Forms.DataGridLineStyle.Solid;
   myDataGridTableStyle1.GridLineColor=Color.Red;

   // Set the HeaderText and Width properties. 
   DataGridColumnStyle myBoolCol = new DataGridBoolColumn();
   myBoolCol.MappingName = "Current";
   myBoolCol.HeaderText = "IsCurrent Customer";
   myBoolCol.Width = 150;
   myDataGridTableStyle1.GridColumnStyles.Add(myBoolCol);

   // Add a second column style.
   DataGridColumnStyle myTextCol = new DataGridTextBoxColumn();
   myTextCol.MappingName = "custName";
   myTextCol.HeaderText = "Customer Name";
   myTextCol.Width = 250;
   myDataGridTableStyle1.GridColumnStyles.Add(myTextCol);

   // Create new ColumnStyle objects
   DataGridColumnStyle cOrderDate = new DataGridTextBoxColumn();
   cOrderDate.MappingName = "OrderDate";
   cOrderDate.HeaderText = "Order Date";
   cOrderDate.Width = 100;

   // Use a PropertyDescriptor to create a formatted column.
   PropertyDescriptorCollection myPropertyDescriptorCollection = BindingContext
      [myDataSet, "Customers.custToOrders"].GetItemProperties();
 
   // Create a formatted column using a PropertyDescriptor.
   DataGridColumnStyle csOrderAmount = 
      new DataGridTextBoxColumn(myPropertyDescriptorCollection["OrderAmount"],
 "c", true);
   csOrderAmount.MappingName = "OrderAmount";
   csOrderAmount.HeaderText = "Total";
   csOrderAmount.Width = 100;
        
   // Add the DataGridTableStyle instances to the GridTableStylesCollection.
   myDataGrid.TableStyles.Add(myDataGridTableStyle1);      
}      
private void GridLineColorChanged_Handler(object
 sender,EventArgs e)
{
   MessageBox.Show("GridLineColor Changed", "DataGridTableStyle");
}   

C++

private:
   void AddCustomDataTableStyle()
   {
      myDataGridTableStyle1 = gcnew DataGridTableStyle;

      // EventHandlers
      myDataGridTableStyle1->GridLineColorChanged += gcnew System::EventHandler(
 this, &DataGridTableStyle_Sample::GridLineColorChanged_Handler
 );
      myDataGridTableStyle1->MappingName = "Customers";

      // Set other properties.
      myDataGridTableStyle1->AlternatingBackColor = System::Drawing::Color::Gold;
      myDataGridTableStyle1->BackColor = System::Drawing::Color::White;
      myDataGridTableStyle1->GridLineStyle = System::Windows::Forms::DataGridLineStyle::Solid;
      myDataGridTableStyle1->GridLineColor = Color::Red;

      // Set the HeaderText and Width properties.
      DataGridColumnStyle^ myBoolCol = gcnew DataGridBoolColumn;
      myBoolCol->MappingName = "Current";
      myBoolCol->HeaderText = "IsCurrent Customer";
      myBoolCol->Width = 150;
      myDataGridTableStyle1->GridColumnStyles->Add( myBoolCol );

      // Add a second column style.
      DataGridColumnStyle^ myTextCol = gcnew DataGridTextBoxColumn;
      myTextCol->MappingName = "custName";
      myTextCol->HeaderText = "Customer Name";
      myTextCol->Width = 250;
      myDataGridTableStyle1->GridColumnStyles->Add( myTextCol );

      // Create new ColumnStyle objects
      DataGridColumnStyle^ cOrderDate = gcnew DataGridTextBoxColumn;
      cOrderDate->MappingName = "OrderDate";
      cOrderDate->HeaderText = "Order Date";
      cOrderDate->Width = 100;

      // Use a PropertyDescriptor to create a formatted column.
      PropertyDescriptorCollection^ myPropertyDescriptorCollection =
         BindingContext[myDataSet, "Customers::custToOrders"]->GetItemProperties();

      // Create a formatted column using a PropertyDescriptor.
      DataGridColumnStyle^ csOrderAmount = gcnew DataGridTextBoxColumn( myPropertyDescriptorCollection[
 "OrderAmount" ],"c",true );
      csOrderAmount->MappingName = "OrderAmount";
      csOrderAmount->HeaderText = "Total";
      csOrderAmount->Width = 100;

      // Add the DataGridTableStyle instances to the GridTableStylesCollection.
      myDataGrid->TableStyles->Add( myDataGridTableStyle1 );
   }

   void GridLineColorChanged_Handler( Object^ /*sender*/, EventArgs^
 /*e*/ )
   {
      MessageBox::Show( "GridLineColor Changed", "DataGridTableStyle"
 );
   }

J#

private void AddCustomDataTableStyle()
{
    myDataGridTableStyle1 = new DataGridTableStyle();

    // EventHandlers          
    myDataGridTableStyle1.add_GridLineColorChanged(
        new System.EventHandler(GridLineColorChanged_Handler));
    myDataGridTableStyle1.set_MappingName("Customers");

    // Set other properties.
    myDataGridTableStyle1.set_AlternatingBackColor(
        System.Drawing.Color.get_Gold());
    myDataGridTableStyle1.set_BackColor(System.Drawing.Color.get_White());
    myDataGridTableStyle1.set_GridLineStyle(
        System.Windows.Forms.DataGridLineStyle.Solid);
    myDataGridTableStyle1.set_GridLineColor(Color.get_Red());

    // Set the HeaderText and Width properties. 
    DataGridColumnStyle myBoolCol = new DataGridBoolColumn();

    myBoolCol.set_MappingName("Current");
    myBoolCol.set_HeaderText("IsCurrent Customer");
    myBoolCol.set_Width(150);
    myDataGridTableStyle1.get_GridColumnStyles().Add(myBoolCol);

    // Add a second column style.
    DataGridColumnStyle myTextCol = new DataGridTextBoxColumn();

    myTextCol.set_MappingName("custName");
    myTextCol.set_HeaderText("Customer Name");
    myTextCol.set_Width(250);
    myDataGridTableStyle1.get_GridColumnStyles().Add(myTextCol);

    // Create new ColumnStyle objects
    DataGridColumnStyle cOrderDate = new DataGridTextBoxColumn();

    cOrderDate.set_MappingName("OrderDate");
    cOrderDate.set_HeaderText("Order Date");
    cOrderDate.set_Width(100);

    // Use a PropertyDescriptor to create a formatted column.
    PropertyDescriptorCollection myPropertyDescriptorCollection = 
        get_BindingContext().get_Item(myDataSet, 
        "Customers.custToOrders").GetItemProperties();

    // Create a formatted column using a PropertyDescriptor.
    DataGridColumnStyle csOrderAmount = new DataGridTextBoxColumn(
        myPropertyDescriptorCollection.get_Item("OrderAmount"), "c",
 true);

    csOrderAmount.set_MappingName("OrderAmount");
    csOrderAmount.set_HeaderText("Total");
    csOrderAmount.set_Width(100);

    // Add the DataGridTableStyle instances to the 
    // GridTableStylesCollection.
    myDataGrid.get_TableStyles().Add(myDataGridTableStyle1);
} //AddCustomDataTableStyle

private void GridLineColorChanged_Handler(Object
 sender, EventArgs e)
{
    MessageBox.Show("GridLineColor Changed", "DataGridTableStyle");
} //GridLineColorChanged_Handler

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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、1.1、1.0

参照

関連項目
DataGridTableStyle クラス
DataGridTableStyle メンバ
System.Windows.Forms 名前空間