Table of Contents
Header and Footer

EO.Wpf ListBox can display a header and a footer in the list. Neither the header nor the footer is considered an item or selectable. The following code demonstrates how to use this feature:

XAML
<Window x:Class="Test.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:eo="http://schemas.essentialobjects.com/wpf/"
        xmlns:g="clr-namespace:System.Globalization;assembly=mscorlib"
        Title="MainWindow" Height="250" Width="350">
    <StackPanel>
        <eo:ListBox Width="200" HorizontalAlignment="Left" ShowHeader="true">
            <eo:ListBox.HeaderTemplate>
                <DataTemplate>
                    <TextBlock Background="WhiteSmoke" FontWeight="Bold">Please select an item</TextBlock>
                </DataTemplate>
            </eo:ListBox.HeaderTemplate>
            <eo:ListBoxItem>Item 1</eo:ListBoxItem>
            <eo:ListBoxItem>Item 2</eo:ListBoxItem>
            <eo:ListBoxItem>Item 3</eo:ListBoxItem>
            <eo:ListBoxItem>Item 4</eo:ListBoxItem>
            <eo:ListBoxItem>Item 5</eo:ListBoxItem>
        </eo:ListBox>
    </StackPanel>
</Window>

The above code produces the following result:

The header and footer can be used to display helpful information, or even contain interative controls such as "shortcuts" for most frequently used items. EO.Wpf ListBox provides a default HeaderTemplate when ShowCheckBoxes is set to true. However it does not provide any default template in single selection mode.