Time Picker

What it is for

The control shows the time as text, with a button beside it. The button opens a drop-down holding a column for each part of the time, each with an up arrow, the value and a down arrow. The user clicks the arrows, holds them down or turns the mouse wheel over them, and the text follows every change. The drop-down closes when the user clicks elsewhere, and can be resized by its bottom edge.

How to use it

• Set TimeValue to the starting time and read it back for the picked time.
• TimeConvention chooses the twelve- or twenty-four-hour clock, and TwelveHoursTimeDisplayFormat or TwentyFourHoursTimeDisplayFormat the way the text is written.
• Interval sets the step of the arrows, and MousePressedValueChangeTriggerSpeed how fast a held arrow repeats.
• DropDownViewOpened tells you when the drop-down opens.

Appearance

The colours of the arrows, the value boxes and the column backgrounds are properties of this control. The look of the text field, the drop-down button and the drop-down window – fonts, borders, size, resize strip – is in DropDownHostConfiguration. The drop-down's parts read their settings when it is first created, so set the appearance before it first opens.

A collection-time picker on a booking form, on the twenty-four-hour clock without seconds.

using System;
using System.Drawing;
using System.Windows.Forms;
using Binarymission.WinForms.Controls.Selectors.TimeSelectors;

var collectionTime = new TimePickerDropDown
{
    Location = new Point(16, 16),
    Size = new Size(180, 32),
    TimeConvention = TimeConvention.TwentyFourHours,
    TwentyFourHoursTimeDisplayFormat = "HH:mm",
    SpinnerBackgroundBrushStartColor = Color.SteelBlue,
    SpinnerHoverBackgroundBrushStartColor = Color.DodgerBlue,
    SpinnerPressedBackgroundBrushStartColor = Color.Navy
};

collectionTime.TimeValue = DateTime.Today.AddHours(9).AddMinutes(30);
collectionTime.DropDownHostConfiguration.PopupCommandVisualNormalBackColor = Color.SteelBlue;
collectionTime.DropDownHostConfiguration.PopupCommandVisualBorderColor = Color.SteelBlue;

collectionTime.DropDownViewOpened += (sender, e) => statusLabel.Text = "Choose a collection time";

bookingForm.Controls.Add(collectionTime);