Group Panel

Jul 07, 2024

Group panels display headers of columns involved in data grouping. They also serve as drag-and-drop targets allowing end-users to drag column headers onto it. Right-clicking the group panel invokes the group panel context menu, which provides grouping related options.

The table below lists the main properties affecting element appearance.

Appearance

GridViewAppearances.GroupPanel

The group panel’s background color cannot be changed using appearance settings in skinning paint styles. To customize the group panel’s background color, create a new skin or skin patch using the Skin Editor tool. In the Skin Editor, the skin element can be found in the following path: GRID > Grouping > Group Panel.

The following code accesses the skin element that corresponds to the group panel and modifies its SolidImageCenter property:

csharp

void ChangeGridGroupPanelColor(Color color, Color color2) {
    SkinElement element = SkinManager.GetSkinElement(SkinProductId.Grid, DevExpress.LookAndFeel.UserLookAndFeel.Default, "GridGroupPanel");

    element.Color.SolidImageCenterColor = color;
    element.Color.SolidImageCenterColor2 = color2;

    //To redraw controls according to the customized skin element, call this static method
    LookAndFeelHelper.ForceDefaultLookAndFeelChanged();
}

| |

Custom Draw Event

GridView.CustomDrawGroupPanel

| |

Text

GridView.GroupPanelText

| |

Visibility

GridOptionsView.ShowGroupPanel

| |

Column Arrangement

GridOptionsView.ShowGroupPanelColumnsAsSingleRow

GridOptionsCustomization.AllowMergedGrouping