Main Menu
Knowledge Base
Product Registration
Log an Incident
Request a Feature
Search Incidents/Bug Reports


Search KB

Please note: In an effort to better serve you, we are in the process of restructuring DevCenter. In the process, we have moved many items that you may be used to finding in DevCenter over to the Main Site. If you are having trouble locating something, please try looking at the following places:

Knowledge Base Article: KB02799

HOWTO:Adding Rows and the AddNewBox


The information in this article applies to:
UltraWebGrid (v1.0.6007)
  Article Created: 
10/30/2002

Last Updated:
10/14/2004

Article Type
How To
  
Page Options
Average Rating:
3 out of 10

Rate this page
Print this page
E-mail this page
Add to Favorites

Summary

The AddNewBox is the area that contains the button that is made available to the user for adding rows to a band in the UltraWebGrid. There is a button provided for each band or level in the hierarchy of the data contained in the UltraWebGrid. By default, the Hidden property of the AddNewBox is set to true; in order to view this area, you would need to set this property to false. In order to be able to add rows, the AllowAddNew property needs to be set to true as well. The appearance of the AddNewBox can be changed through the Style object of the AddNewBox.

Additional Information

The following code makes the AddNewBox visible, changes the setting for allowing the addition of rows and sets the BackColor of the AddNewBox:

In VB.Net:

        UltraWebGrid1.DisplayLayout.AddNewBox.Hidden = False
        UltraWebGrid1.DisplayLayout.AllowAddNewDefault = Infragistics.WebUI.UltraWebGrid.AllowAddNew.Yes
        UltraWebGrid1.DisplayLayout.AddNewBox.Style.BackColor = Color.Red

In C#:

        UltraWebGrid1.DisplayLayout.AddNewBox.Hidden = false;
        UltraWebGrid1.DisplayLayout.AllowAddNewDefault = Infragistics.WebUI.UltraWebGrid.AllowAddNew.Yes;
        UltraWebGrid1.DisplayLayout.AddNewBox.Style.BackColor = Color.Red;

It is also possible to add rows to the grid through code. To add rows through the server-side, use the Add method of the Rows collection. The following code will add a new row to the very bottom of the grid:

In VB.Net:

        UltraWebGrid1.DisplayLayout.Rows.Add()

In C#:

        UltraWebGrid1.DisplayLayout.Rows.Add();

If you would like to add rows through client-side script, the Hidden Property of the AddNewBox must be set to false. If you do not want the AddNewBox to be visible, but still want the capability to add rows on the client-side then use the CustomRules property of the AddNewBox to hide it. The following code will hide the AddNewBox through the CustomRules property:

In VB.Net:

        UltraWebGrid1.DisplayLayout.AddNewBox.Style.CustomRules = "display:none;"

In C#:

        UltraWebGrid1.DisplayLayout.AddNewBox.Style.CustomRules = "display:none;";

The javascript necessary to add a row is below. The AddNew method must be passed the ID of the grid and the index of the band in which to add the row:

        igtbl_addNew("UltraWebGrid1",0);

Related Articles

HOWTO: UltraWebGrid sample detailing manipulation of the headers, footers and data validation (KB03032)

Samples

abwebgridtutorial.zip
 This sample demonstrates how to perform several client side tasks, adding rows, deleting rows, confirming/canceling deletes, expanding rows, collapsing rows. In the HTML you will see many utility functions that are used to select rows, deselect rows, set activerow, get parent rows/child rows/sibling rows. Initializing row values on the server and expanding/collapsing all on the server. C# and VB versions


webgrid_rowloopingrowheight.zip
 VB.NET. This sample demonstrates a number of concepts including updating header and footer text, arrange columns in the desired order and setting their widths, hiding the addnew box but allowing addnew functionality, adding rows without default values when default values are set, data validation on both the client and the server, allowing the user to resize rows independently, and looping through all the rows in a given band.


webgrid_rowloopingrowheightcs.zip
 C#. This sample demonstrates a number of concepts including updating header and footer text, arrange columns in the desired order and setting their widths, hiding the addnew box but allowing addnew functionality, adding rows without default values when default values are set, data validation on both the client and the server, allowing the user to resize rows independently, and looping through all the rows in a given band..



How would you rate the quality of this content?
Poor -----------------------------------------> Outstanding

Tell us why you rated the content this way. (optional)