Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]General Information
[Collapse]WinForms Controls
  Prerequisites
 [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]Data Binding
   [Expand]Views
   [Expand]Data Editing and Validation
   [Expand]Grouping
   [Expand]Sorting
   [Expand]Filter and Search
   [Expand]Summaries
   [Expand]Focus and Selection Handling
    Formatting Cell Values
   [Expand]Master-Detail Relationships
   [Expand]Asynchronous Image Load
   [Expand]Export and Printing
   [Expand]Appearance and Conditional Formatting
    Split Presentation
    Row Preview Sections
    Scrolling
   [Expand]Batch Modifications
   [Expand]Hit Information
    Hints
   [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
      Band Header
      Band Panel
      Band Panel Button
    [Expand]Master-Detail Mode Related Elements
   [Expand]Design-Time Features
   [Expand]Examples
   [Expand]End-User Capabilities
    Included Components
  [Expand]Vertical Grid
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Chart Control
  [Expand]Diagrams
  [Expand]Gauges
  [Expand]Map Control
  [Expand]Scheduler
  [Expand]Spreadsheet
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]Printing-Exporting
  [Expand]PDF Viewer
   Reporting
  [Expand]Snap
  [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]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Document Server
[Expand]Reporting
[Expand]Report Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]CodeRush Classic
[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?​​​​​​​