Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

NavBarGroupControlContainer Class

Represents the container displayed within a NavBar group when this group’s NavBarGroup.GroupStyle property is set to NavBarGroupStyle.ControlContainer.

Namespace: DevExpress.XtraNavBar

Assembly: DevExpress.XtraNavBar.v24.2.dll

NuGet Package: DevExpress.Win

#Declaration

public class NavBarGroupControlContainer :
    XtraScrollableControl,
    ITransparentBackgroundManager,
    ITransparentBackgroundManagerEx

The following members return NavBarGroupControlContainer objects:

#Remarks

A NavBarControl allows any controls to be displayed within NavBar groups. To do this, set the group’s NavBarGroup.GroupStyle property to NavBarGroupStyle.ControlContainer. This automatically creates a NavBarGroupControlContainer control and displays it within the specified group. Then you can place any controls onto the container and these will be displayed when the group is expanded.

To get the group’s control container, use the NavBarGroup.ControlContainer property. This property returns a valid value (not null) only when the NavBarGroup.GroupStyle property is set to NavBarGroupStyle.ControlContainer. In other cases, the group’s control container does not exist and the NavBarGroup.ControlContainer property returns null.

Note

Before accessing and customizing the NavBarGroupControlContainer, ensure that the group has been added to the NavBarControl.Groups collection.

Note

Switching the NavBarGroup.GroupStyle property from NavBarGroupStyle.ControlContainer to another value destroys the control container and all the controls owned by the container.

The control container fills the entire group’s region. The visible height of the control container can be specified via the NavBarGroup.GroupClientHeight property.

The following image shows a NavBar group displaying a Tree List control. The Tree List is placed onto the group’s control container.

GroupStyle_ControlContainer_TreeList

#Example

The following sample code embeds a DateControl into a NavBarControl’s group. To allow control embedding, the NavBarGroup.GroupStyle property is set to ControlContainer. Then, the DateControl is added to the group via the NavBarGroup.ControlContainer property.

The image below shows the result.

embedding_datecontrol_into_a_group

DevExpress.XtraEditors.DateControl dc = new DevExpress.XtraEditors.DateControl();

navBarGroup1.GroupStyle = DevExpress.XtraNavBar.NavBarGroupStyle.ControlContainer;
navBarGroup1.ControlContainer.Controls.Add(dc);                     
navBarGroup1.GroupClientHeight = dc.Height + 3;
navBarControl1.Width = dc.Width + 3;
See Also