Please enable JavaScript to view this site.

R:BASE 11 Help

Navigation: How To (Forms, Reports, and more) > Forms > Form Designer > Form Controls > Database Controls > DB Tree List > Bands

Properties

Scroll Prev Top Next More

 

ð General

Caption

Specifies the display caption for the band

Width

Specifies the band width in pixels

Minimum Width

Returns the band's minimum possible width in pixels

Best Fit Maximum Width

Adjusts the band's width to the maximum required width in order to display the content of all columns in their entirety

Expandable

Specifies whether the current band is able to display expand buttons (also called an expandable band).

Default - Expand buttons are displayed within the first visible bottom band, if none of the other bands are set as Expandable.

Expandable - The band displays expand buttons. If multiple bands are set as Expandable, the first visible bottom band will display expand buttons. If the categorized paint style is applied to the DB Tree List control, the expandable band is always considered to be the first visible bottom band.

Not Expandable - The band cannot display expand buttons. If all visible bands are set as Not Expandable, expand buttons are not painted within the DB Tree List control.

Fixed Kind

Specifies whether the band is involved in horizontal scrolling

None - the band is not fixed

Left - the band is fixed to the control’s left side

Right - the band is fixed to the control’s right side

Visible

Specifies if the band is visible

 

ð Header

Horizontal Alignment

Specifies the horizontal justification of the text within the band header

Vertical Alignment

Specifies the vertical justification of the text within the band header

Glyph

Specifies a glyph image to display for the header, which can be loaded, deleted, and previewed

Glyph Horiz Alignment

Specifies the horizontal justification of the glyph within the column header

Glyph Vert Alignment

Specifies the vertical justification of the glyph within the column header

Multi Line

Specifies whether the caption is drawn across several lines

Show End Ellipsis

Specifies whether to display an end ellipsis when the content is clipped

 

ð Position

Band Index

Specifies the band's parent band. The parent band is identified by its "index" within the DB Tree List control's band collection. To remove a band from its parent band, set the Band Index property to –1. As a result, the band is positioned at the root nesting level. Incremental values are used to define multi-level bands.

Column Index

Specifies the band's horizontal position (note that a band can be interpreted as a column). For nested bands, this property specifies the position of a band within its parent band's child band collection. For root bands, the Column Index property specifies a band's root index property value.

 

The image below displays an example using Band Index and Column Index values.

 

DBTreeList_Band_Props

 

In the below, the Band Index of the "Company Structure" and "Miscellaneous Information" bands is -1, because those are parent bands. The Band Index of the "Address" band is 1. The Column Index for the "Company Structure" band is 0. The Column Index for the "Miscellaneous Information" band is 1.

 

DBTreeList_BandSample