NavBarGroup.HeaderTemplateCollapsed Property

Gets or sets a template used for displaying the content of the group’s header when the group is in a collapsed state.

Namespace: DevExpress.Web

Assembly: DevExpress.Web.v24.1.dll

NuGet Package: DevExpress.Web

Declaration

C#

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

VB.NET

<DefaultValue(Nothing)>
Public Overridable Property HeaderTemplateCollapsed 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 the collapsed group’s header.

Remarks

Use the HeaderTemplateCollapsed property to control the contents of the header for the collapsed state of the current group. The template defined using this property replaces the content of the group header (in particular, the image and text associated with the header) when the group is collapsed.

Note that any style settings defined for the header via the specific properties (such as the ASPxNavBar.GroupHeaderStyleCollapsed or NavBarGroup.HeaderStyleCollapsed) are still in effect for the collapsed group’s header, whose content is specified through using the HeaderTemplateCollapsed property.

In order to define a common content for all headers of the collapsed groups within a navbar control, the navbar’s ASPxNavBar.GroupHeaderTemplateCollapsed property can be used.

Note

Once a template defined via the HeaderTemplateCollapsed 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.

 

Note

If you defined the HeaderTemplate template content and had not defined the HeaderTemplateCollapsed template, the HeaderTemplateCollapsed template content will be automatically generated. All the controls within the HeaderTemplate content will be automatically added to the HeaderTemplateCollapsed template content (with the new Control.ID property value). It is recommended that you define the template content for both HeaderTemplate and HeaderTemplateCollapsed.

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);

     group1.HeaderTemplate = new MyTemplate();
     group1.HeaderTemplateCollapsed = 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)

     group1.HeaderTemplate = New MyTemplate()
     group1.HeaderTemplateCollapsed = 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