Xceed DataGrid for Silverlight Documentation
Headers Property
Example 


Xceed.Silverlight.DataGrid.v2.0 Assembly > Xceed.Silverlight.DataGrid Namespace > DataGridGroupConfiguration Class : Headers Property
Gets a collection of DataTemplates that represent the elements that are located in the header sections of the groups to which the configuration is applied.
Syntax
'Declaration
 
Public ReadOnly Property Headers As ObservableCollection(Of DataTemplate)
'Usage
 
Dim instance As DataGridGroupConfiguration
Dim value As ObservableCollection(Of DataTemplate)
 
value = instance.Headers
public ObservableCollection<DataTemplate> Headers {get;}

Property Value

A generic ObservableCollection of DataTemplates that represent the elements that are located in the header sections of the groups to which the configuration is applied.
Remarks

All items added to a header or footer section must be provided as a DataTemplate.

The GroupContext attached property will only be set on the first (i.e., root) element in the DataTemplate and can be accessed through a RelativeSource binding using the Self mode (see examples example below). Any child elements in the template can access the parent's GroupContext through an ElementName binding. For example:

<TextBlock Text="{Binding ElementName=parentPanel,
                                         Path=(sldg:DataGridControl.GroupContext).GroupValue}" />

Example

The following example demonstrates how to dynamically display a label in group headers.

The code for the LanguageToVisibilityConverter class can be found in the Additional Resources section of the documentation. 

<sldg:DataGridControl x:Name="sldgDataGridControl"
                      ItemsSource="{Binding Path=Orders}">
    <sldg:DataGridControl.Resources>
        <local:LanguageToVisibilityConverter x:Key="languageToVisibilityConverter" />
    </sldg:DataGridControl.Resources>
    <sldg:DataGridControl.GroupDescriptions>
        <sldg:DataGridGroupDescription PropertyName="ShipCountry">
            <sldg:DataGridGroupDescription.GroupConfiguration>
                <sldg:DataGridGroupConfiguration>
                    <sldg:DataGridGroupConfiguration.Headers>
                        <DataTemplate>
                            <TextBlock Text="{Binding RelativeSource={RelativeSource Self}, Path=(sldg:DataGridControl.GroupContext).GroupValue, StringFormat='{}{0} is a French-speaking country'}"
                                       Visibility="{Binding RelativeSource={RelativeSource Self}, Path=(sldg:DataGridControl.GroupContext), Converter={StaticResource languageToVisibilityConverter}}" />                    
                        </DataTemplate>
                    </sldg:DataGridGroupConfiguration.Headers>
                </sldg:DataGridGroupConfiguration>
            </sldg:DataGridGroupDescription.GroupConfiguration>
        </sldg:DataGridGroupDescription>
    </sldg:DataGridControl.GroupDescriptions>
</sldg:DataGridControl>
Requirements

Target Platforms: Windows 7, Windows Vista, Windows XP SP3, Windows Server 2008 family

See Also

Reference

DataGridGroupConfiguration Class
DataGridGroupConfiguration Members
Footers Property

Send Feedback