LayoutGroup.Header Property

Gets or sets the group’s header. This is a dependency property.

Namespace: DevExpress.Xpf.LayoutControl

Assembly: DevExpress.Xpf.LayoutControl.v20.2.dll

NuGet Packages: DevExpress.WindowsDesktop.Wpf.LayoutControl, DevExpress.Wpf.Layout

Declaration

C#

public object Header { get; set; }

VB.NET

Public Property Header As Object

Property Value

Type	Description
Object	An object that represents the group’s header.

Remarks

The object specified by the Header property is displayed in the following cases:

• the group is represented as a GroupBox (the LayoutGroup.View property is set to LayoutGroupView.GroupBox)

• the group is represented as a tab within a tabbed group (the LayoutGroup.View property is set to LayoutGroupView.Tabs).

  It’s possible to use the LayoutControl.TabHeader attached property to specify a tab header for any object displayed as a tab. The LayoutControl.TabHeader attached property, if specified, overrides the Header property.

Typically, you assign a text string to the Header or LayoutControl.TabHeader property. However, you can assign any object, and then specify how this object is rendered, by providing a template. To provide a template, use the LayoutGroup.HeaderTemplate property or the LayoutControl.TabHeaderTemplate attached property. The LayoutControl.TabHeaderTemplate attached property, if specified, overrides the LayoutGroup.HeaderTemplate property.

The Header property is not supported by the LayoutControl.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the Header property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

XAML

how-to-implement-custom-collection-that-loads-data-asynchronously-e4729/CS/AsyncDataLoading/Content.xaml#L18

<dxlc:LayoutGroup Orientation="Horizontal">
    <dxlc:LayoutGroup Header="DXGrid" View="GroupBox">
        <dxg:GridControl x:Name="grid">

how-to-customize-layoutcontrols-customizationpopup-e3551/CS/CustomizationPopup/MainPage.xaml#L13

<local:MyLayoutControl IsCustomization="True">
    <dxlc:LayoutGroup Header="Group 1">
        <dxlc:LayoutItem Label="Item 1">

how-to-prevent-dragging-elements-from-layoutgroup-e4195/CS/LayoutCntMoveInGroup/MainWindow.xaml#L8

<dxlc:LayoutGroup>
    <my:MyLayoutGroup Header="IsolatedLayoutGroup" x:Name="layoutGroup1" View="GroupBox" Height="169" Width="200" IsIsolatedGroup="True" Orientation="Vertical">
        <dxlc:LayoutItem Label="layoutItem1" Name="layoutItem1">

how-to-implement-the-itemssource-property-for-the-layoutgroup-layoutcontrol-control-e5081/CS/LayoutControlItemsSource/MainWindow.xaml#L40

</dxlc:LayoutGroup>
<dxlc:LayoutGroup Header="Orientation='Horizontal'" Orientation="Horizontal" View="GroupBox">
    <dxmvvm:Interaction.Behaviors>

C#

how-to-prevent-dragging-elements-from-layoutgroup-e4195/CS/LayoutCntMoveInGroup/MyLayoutControlCustomizationController.cs#L47

item.IsIsolatedGroup = true;
item.Header = itemInfo.Label;
item.View = LayoutGroupView.GroupBox;

VB.NET

how-to-prevent-dragging-elements-from-layoutgroup-e4195/VB/LayoutCntMoveInGroup/MyLayoutControlCustomizationController.vb#L43

item.IsIsolatedGroup = True
item.Header = itemInfo.Label
item.View = LayoutGroupView.GroupBox