Log In
[Expand]General Information
[Collapse]WinForms Controls
 [Expand]What's Installed
 [Expand]Build an Application
 [Collapse]Controls and Libraries
  [Expand]Forms and User Controls
  [Expand]Messages, Notifications and Dialogs
  [Expand]Editors and Simple Controls
  [Expand]Ribbon, Bars and Menu
  [Expand]Application UI Manager
  [Expand]Docking Library
  [Collapse]Data Grid
   [Expand]Getting Started
   [Expand]Binding to Data
   [Expand]Grid View
   [Expand]View Technology
   [Expand]Data Editing
   [Expand]Filtering and Locating Rows
   [Expand]Focus and Selection Handling
   [Expand]Processing Rows
   [Expand]Formatting Cell Values
   [Expand]Master-Detail Relationships
   [Expand]Asynchronous Image Load
   [Expand]Export and Printing
   [Expand]Appearance and Conditional Formatting
   [Expand]Batch Modifications
   [Expand]Hit Information
   [Expand]Popup Menus
   [Expand]Saving and Restoring Layouts
   [Collapse]Visual Elements
    [Expand]Grid Control Elements
    [Expand]View Common Elements
    [Expand]Grid View Elements
    [Expand]Card View Elements
    [Expand]Layout View Elements
    [Collapse]Banded Grid View Elements
      Band Header
      Band Panel
      Band Panel Button
    [Expand]Master-Detail Mode Related Elements
   [Expand]Design-Time Features
   [Expand]End-User Capabilities
    Included Components
  [Expand]Vertical Grid
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Chart Control
  [Expand]Map Control
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]PDF Viewer
  [Expand]TreeMap Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Document Server
[Expand]Report Server
[Expand]eXpressApp Framework
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

Band Header

The band header identifies a band in banded and Advanced Banded Grid Views. The end-user can move a band to another position or to the Customization Form by dragging its header. Dragging the header edge allows a user to change the band's width.

Visible band headers are presented within the band panel. Hidden band headers are displayed within the Customization Form.



The table below lists the main properties affecting visual element appearance.

Appearance The BandedViewAppearances.BandPanel property determines the default appearance settings applied to all band headers.

The GridBand.AppearanceHeader property allows you to override the default style for individual bands.

Note: These appearance settings are not in effect if the View is painted using a Windows XP theme (see BaseView.PaintStyleName).

Custom Draw Event BandedGridView.CustomDrawBandHeader
Visibility The BandedGridOptionsView.ShowBands property specifies whether the band panel is visible.

The OptionsBand.ShowInCustomizationForm band option specifies whether hidden bands are displayed within the Customization Form.

Text GridBand.Caption
Image GridBand.Image, GridBand.ImageIndex, GridBand.ImageAlignment
Height GridBand.RowCount, BandedGridColumn.AutoFillDown, BandedGridView.BandPanelRowHeight, BandedGridView.MinBandPanelRowCount

Banded and Advanced Banded Grid Views allow you to change the band header height and arrange band headers in several rows via the GridBand.RowCount property The GridBand.AutoFillDown property specifies whether or not a header should be automatically stretched vertically if there is an empty space below it. This has been provided because users can sometimes rearrange bands leaving an empty space within a band panel. Setting the GridBand.AutoFillDown property to true (the default) avoids this.

The image below shows the relation between the GridBand.RowCount and GridBand.AutoFillDown properties.

Tooltips BandedGridOptionsHint.ShowBandHeaderHints, GridBand.ToolTip

Expanded See Also

How would you rate this topic?​​​​​​​