Displaying a New Row at the Top

In the GcMultiRow control, you can specify whether to display a new row at the top, or at the bottom of the grid.

Specifying the Display Position

Use the GcMultiRow.NewRowPosition property to specify the display position of the new row. To display the new row at the top of the grid, set the GcMultiRow.NewRowPosition property to Top.

Using Code

This example sets the NewRowPosition property.

[VB]

GcMultiRow1.NewRowPosition = GrapeCity.Win.MultiRow.NewRowPosition.Top

[CS]

gcMultiRow1.NewRowPosition = GrapeCity.Win.MultiRow.NewRowPosition.Top;

New Row Separator

A separator is displayed to separate the new row from the other rows, when you display the new row at the top of the grid. Use the GcMultiRow.NewRowSeparatorStyle property to set the style of the separator.

The Separator feature is only available to display the new row at the top of the grid.

Using Code

This example sets the new row separator.

[VB]

GcMultiRow1.NewRowSeparatorStyle = New GrapeCity.Win.MultiRow.SplitStyle(SystemColors.Control, SystemColors.ControlDark, SystemColors.ControlLight, 4)

[CS]

gcMultiRow1.NewRowSeparatorStyle = new GrapeCity.Win.MultiRow.SplitStyle(SystemColors.Control, SystemColors.ControlDark, SystemColors.ControlLight, 4);

Alternating Display of a New Row

You can display alternate text instead of a new row, by using the GcMultiRow.NewRowAlternateText property. Set the GcMultiRow.NewRowAlternateText.Visible property to True, to display alternate text.

Using Code

This example displays alternate text.

[VB]

GcMultiRow1.NewRowAlternateText.Visible = True
GcMultiRow1.NewRowAlternateText.Text = "Please click here to add a new row." 
GcMultiRow1.NewRowAlternateText.ForeColor = SystemColors.WindowText
GcMultiRow1.NewRowAlternateText.BackColor = Color.Azure 
GcMultiRow1.NewRowAlternateText.TextAlignment = ContentAlignment.MiddleCenter

[CS]

gcMultiRow1.NewRowAlternateText.Visible = true; 
gcMultiRow1.NewRowAlternateText.Text = "Please click here to add a new row." ;
gcMultiRow1.NewRowAlternateText.ForeColor = SystemColors.WindowText; 
gcMultiRow1.NewRowAlternateText.BackColor = Color.Azure;
gcMultiRow1.NewRowAlternateText.TextAlignment = ContentAlignment.MiddleCenter;