Version

Band Property (AddNewRowButtonUIElement)

The UltraGridBand object represents all the rows that occur at a single level of a hierarchical data set. Bands can be expanded or collapsed to display the data in the rows they contain.
Syntax
'Declaration
 
Protected ReadOnly Property Band As UltraGridBand
protected UltraGridBand Band {get;}
Remarks

The UltraGridBand object represents all the records at one level of a hierarchical recordset. Bands are the foundation of hierarchical data in the UltraWinGrid. When bound to a recordset, each band corresponds to a single Command. (A band can also be considered as roughly equivalent to the table or query level of organization within a database.) Although the rows in a band may be visually separated (appearing grouped under the rows of the next higher band in the hierarchy) they are in fact one set of records. In the data hierarchy of the grid, bands come after the grid itself, but before rows and cells.

There is always at least one UltraGridBand present in the UltraWinGrid, even when it is displaying a single-level (flat) recordset. Most of the properties that apply to the control at the topmost (grid) level also apply to the UltraGridBand object, since the band rather than the control is the primary container object for data. There is also broad support for applying different formatting and behavior attributes to individual bands. Since a band is effectively "a grid within a grid" you may want to have bands be markedly different from one another. For example, one band might display column headers and row selectors for each group of records, while another might display only data cells.

Bands can be displayed either horizontally or vertically within the grid, depending on the setting of the ViewStyleBand property. You can also hide entire bands from view by setting the Hidden property of the UltraGridBand object.

Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Server 2012, Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

See Also