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

NavBarCalcGroupClientHeightEventArgs.Height Property

Gets or sets the group’s client area height.

Namespace: DevExpress.XtraNavBar

Assembly: DevExpress.XtraNavBar.v24.2.dll

NuGet Package: DevExpress.Win

#Declaration

public int Height { get; set; }

#Property Value

Type Description
Int32

An integer value specifying the height of the group’s client area in pixels.

#Remarks

When the NavBarGroup.CalcGroupClientHeight event is invoked, the automatically calculated group client area height is assigned to the Height property. Assign a value to this property to implement custom height for the group’ client area.

#Example

The following sample code handles the NavBarControl.CustomDrawGroupClientForeground event to custom paint the text on a group’s client foreground. The group doesn’t contain any links initially and thus the NavBarGroup.CalcGroupClientHeight event is handled to specify the group’s height.

The image below shows the result.

CustomDraw - GroupClientForeground

using DevExpress.XtraNavBar.ViewInfo;
using DevExpress.XtraNavBar;

readonly Font mailFont = new Font("Verdana", 8, FontStyle.Bold);
readonly Font siteFont = new Font("Verdana", 8);
private void navBarControl1_CustomDrawGroupClientForeground(object sender, 
  CustomDrawObjectEventArgs e) {
    // Identifying the processed group.
    NavGroupClientInfoArgs info = e.ObjectInfo as NavGroupClientInfoArgs;
    if(info.Group.Caption != "Support Info") return;

    // Specifying the text rectangle.    
    Rectangle rect = e.RealBounds;
    rect.Height /= 4;

    // Formatting the output string.
    using(var outStringFormat = new StringFormat()) {
        outStringFormat.Alignment = StringAlignment.Near;
        outStringFormat.LineAlignment = StringAlignment.Center;

        // Painting the first string.
        rect.Offset(0, rect.Height);
        e.Cache.DrawString("E-mail:", mailFont,
            Brushes.Black, rect, outStringFormat);

        // Painting the second string.
        rect.Offset(0, rect.Height);
        e.Cache.DrawString("noreply@devexpress.com", siteFont,
            Brushes.Black, rect, outStringFormat);
    }

    // Prohibiting default painting.
    e.Handled = true;
}

private void navBarGroup2_CalcGroupClientHeight(object sender, 
  NavBarCalcGroupClientHeightEventArgs e) {
   e.Height = 70;        
}
See Also