Rh.DateRange.Picker 1.0.0

Rh.DateRange.Picker

A WPF control for choosing date ranges. Derives from Control. Requires .NET Framework 4.0.

It shows

• two date pickers for selecting dates,
• list of predefined ranges,
• buttons to step to the previous or the next range while preserving its meaning. For example, for the "Month To Date", if today is 5/24/2017, the previous range will be the period from 4/1/2017 to 4/24/2017.

For a complete demo of the control, check out the project Rh.DateRange.Picker.Examples.

How To Install

Install the nuget package, or build Rh.DateRange.Picker and add reference to it in your application project.

How To Use

Add the namespace mapping xmlns:rh="http://schemas.rollinghours.com/wpf" to your XAML. Create an instance of the control in your XAML file. Bind the From and To properties to the corresponding ViewModel properties.

Minimal Use

Specify the From and To properties:

<rh:DateRangePicker From="{Binding DateFrom}" To="{Binding DateTo}" />

Storing values in application settings

<Window 
...
xmlns:p="clr-namespace:MyProject.Properties">
...
  <rh:DateRangePicker From="{Binding DateRangeFrom, Source={x:Static p:Settings.Default}}"
                      To="{Binding DateRangeTo, Source={x:Static p:Settings.Default}}"
                      KindOfRange="{Binding DateRangeKind, Source={x:Static p:Settings.Default}}" />
 ...
</Window>

Vertical layout

Use the Orientation property to control the internal layout of the control:

<rh:DateRangePicker From="{Binding DateFrom}"
                    To="{Binding DateTo}"
                    KindOfRange="{Binding DateRangeKind}"
                    Orientation="Vertical" />

Non-inherited properties and events

Data-related properties

Events

UI-related properties

Styling the internal controls

How to avoid changing an internal control style of the DateRangePicker by a global default style

A default global style targeted to DatePicker, Button or ComboBox may affect the internals of the DateRangePicker. To avoid this, define the empty default style for the same target type but in the scope of the control. For example, if your default style is

    <Window.Resources>
        <ResourceDictionary>
            <Style TargetType="Button">
                <Setter Property="Background" Value="LightGreen"/>
                <Setter Property="Width" Value="75"/>
            </Style>
        </ResourceDictionary>
    </Window.Resources>

set the internal button style like this:

            <rh:DateRangePicker From="{Binding DateFrom}" To="{Binding DateTo}">
                <rh:DateRangePicker.Style>
                    <Style>
                        <Style.Resources>
                            <Style TargetType="Button" />
                        </Style.Resources>
                    <Style>
                </rh:DateRangePicker.Style>
            </rh:DateRangePicker

How to apply a custom style to the internal elements

DateRangePicker has TextBlock, Button, DatePicker and ComboBox elements inside. TextBlocks can be styled with dedicated properties DatePickerCaptionTextBlockStyle and NavigationButtonTextBlockStyle. To apply a custom style to the other elements, set your custom style as the default style for the target type like here:

            <rh:DateRangePicker From="{Binding DateFrom}" To="{Binding DateTo}">
                <rh:DateRangePicker.Style>
                    <Style>
                        <Style.Resources>

for navigation buttons:

                            
                            <Style TargetType="Button">
                                <Setter Property="Background" Value="LightGreen"/>
                                <Setter Property="Width" Value="75"/>
                            </Style>

for date pickers:

                            
                            <Style TargetType="DatePicker">
                                <Setter Property="BorderBrush" Value="CornflowerBlue"/>
                            </Style>

for the combo box:

                            
                            <Style TargetType="ComboBox">
                                
                                <Setter Property="Template" Value="{StaticResource ResourceKey=MyComboBoxTemplate}"/>
                            </Style>
                        </Style.Resources>
                    <Style>
                </rh:DateRangePicker.Style>
            </rh:DateRangePicker