ASPxNavBar.GroupHeaderTemplateCollapsed Property

Gets or sets a common template used for displaying the content of the headers of all collapsed groups within the navbar control.

Namespace: DevExpress.Web

Assembly: DevExpress.Web.v24.1.dll

NuGet Package: DevExpress.Web

Declaration

C#

[DefaultValue(null)]
public virtual ITemplate GroupHeaderTemplateCollapsed { get; set; }

VB.NET

<DefaultValue(Nothing)>
Public Overridable Property GroupHeaderTemplateCollapsed As ITemplate

Property Value

Type	Default	Description
ITemplate	null	An object supporting the System.Web.UI.ITemplate interface which contains the template used for displaying the content of all collapsed group headers within the navbar.

Remarks

Use the GroupHeaderTemplateCollapsed property to define a common content for the headers of all collapsed groups within the current navbar control. The template created using this property replaces the content of each collapsed group’s header within the navbar - in particular, the image and text associated with the header.

Note that any style settings defined for the collapsed group headers via the specific properties (such as the ASPxNavBar.GroupHeaderStyleCollapsed or NavBarGroup.HeaderStyleCollapsed) are still in effect for the headers whose contents are specified, using the GroupHeaderTemplateCollapsed property.

The content of a particular collapsed group’s header can be defined using the group’s NavBarGroup.HeaderTemplateCollapsed property.

Note

Once a template defined via the GroupHeaderTemplateCollapsed property is created within a tab control, it is instantiated within a container object of the NavBarGroupTemplateContainer type. This container object exposes a set of specific properties to which the template’s child controls can be bound.

Example

This example demonstrates how to modify the ASPxNavBar‘s group header content.

C#

using DevExpress.Web.ASPxNavBar;
...
protected void Page_Load(object sender, EventArgs e) {
     NavBarGroup group1 = new NavBarGroup("group1", "group1");
     NavBarItem item1 = new NavBarItem("item1", "item1");

     ASPxNavBar1.Groups.Add(group1);
     group1.Items.Add(item1);

     ASPxNavBar1.GroupHeaderTemplate= new MyTemplate();
     ASPxNavBar1.GroupHeaderTemplateCollapsed = new MyTemplate1();
}

public class MyTemplate : ITemplate {
     void ITemplate.InstantiateIn(Control container) {
          Label label = new Label();
          label.Text = "The group is expanded";
          container.Controls.Add(label);
     }
}

public class MyTemplate1 : ITemplate {
     void ITemplate.InstantiateIn(Control container) {
          Label label2 = new Label();
          label2.Text = "The group is collapsed";
          container.Controls.Add(label2);
     }
}

VB.NET

Imports DevExpress.Web.ASPxNavBar
... 
Protected Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
     Dim group1 As New NavBarGroup("group1", "group1")
     Dim item1 As New NavBarItem("item1", "item1")

     ASPxNavBar1.Groups.Add(group1)
     group1.Items.Add(item1)

     ASPxNavBar1.GroupHeaderTemplate= New MyTemplate()
     ASPxNavBar1.GroupHeaderTemplateCollapsed = New MyTemplate1()
End Sub

Public Class MyTemplate
     Implements ITemplate
     Private Sub InstantiateIn(ByVal container As Control) Implements ITemplate.InstantiateIn
          Dim label As New Label()
          label.Text = "The group is expanded"
          container.Controls.Add(label)
     End Sub
End Class

Public Class MyTemplate1
     Implements ITemplate
     Private Sub InstantiateIn(ByVal container As Control) Implements ITemplate.InstantiateIn
          Dim label2 As New Label()
          label2.Text = "The group is collapsed"
          container.Controls.Add(label2)
     End Sub
End Class