DataGridTableStyle.AlternatingBackColor-Eigenschaft

Ruft die Hintergrundfarbe der ungeraden Datenblattzeilen ab oder legt diese fest.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
Public Property AlternatingBackColor As Color
'Usage
Dim instance As DataGridTableStyle
Dim value As Color

value = instance.AlternatingBackColor

instance.AlternatingBackColor = value

public Color AlternatingBackColor { get; set; }

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

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

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

public function get AlternatingBackColor () : Color

public function set AlternatingBackColor (value : Color)

Eigenschaftenwert

Eine Color, die die Hintergrundfarbe ungerader Zeilen darstellt. Der Standardwert ist Window.

Beispiel

Im folgenden Codebeispiel wird eine Instanz von DataGridTableStyle erstellt, und die BackColor-Eigenschaft und die AlternatingBackColor-Eigenschaft werden auf neue Werte festgelegt. Für dieses Beispiel ist es erforderlich, dass ein DataGrid mit einem System.Data.DataSet, das Daten enthält, und ein Button in einem Form vorhanden sind.

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

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");
}   

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" );
   }

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

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

DataGridTableStyle-Klasse
DataGridTableStyle-Member
System.Windows.Forms-Namespace