DateTimePicker и MonthCalendar

DateTimePicker          и                        MonthCalendar

Элемент управления DateTimePicker позволяет пользователю выби- рать дату и время и отображать их в указанном формате.

Календарь MonthCalendar – частный случай ЭУ DateTimePicker. По- зволяет выбрать дату и возвратить ее значение.

ShowCheckBox=true

ShowUpDown = true

Format = Time

MonthCalendar

Восстановить текущую дату рис.17

Свойство Value получает или задает значение даты/времени, назна- чаемое элементу управления. Если свойство Value не было изменено ко-

дом или пользователем в окне свойств, ему присваивается значение те- кущей даты и времени (DateTime.Now).

Описание свойства:

public DateTime Value {get; set;}

Примеры установки текущих значений:

dateTimePicker1.Value = DateTime.Now.AddDays(1); dateTimePicker2.Value = new System.DateTime(2007, 5, 13, 14, 34, 8, 0);

AddDays(1) - добавляет указанное число дней к значению этого эк- земпляра.

Ограничить количество выбираемых значений даты и времени можно с помощью настройки свойств MinDate и MaxDate.

Чтобы изменить вид части элементов управления календарем, следу- ет настроить свойства CalendarForeColor, CalendarFont, CalendarTitleBackColor, CalendarTitleForeColor, CalendarTrailingForeColor и CalendarMonthBackground.

Свойство Format определяется значением из перечисления DateTimePickerFormat элемента управления. По умолчанию свойству Format для даты присваивается значение DateTimePickerFormat.Long.

Другие значения перечисления: Short, Time, Custom.

Если свойство Format имеет значение DateTimePickerFormat.Custom, можно создать собственный стиль формата путем настройки свойства CustomFormat и построения настраиваемой строки формата.

Пример, при указании для свойства CustomFormat значения "ddMMMMyyyy   HH:mm:ss", дата будет отображена следующим обра- зом: «13 мая 2007 г. 11:52:05».

Чтобы использовать элемент управления в стиле «вверх и вниз» для настройки значения даты и времени, следует задать для свойства ShowUpDown значение true. Если элемент управления календарем выде- лен, он не раскроется.

Значения даты/времени можно настроить путем выделения каждого элемента по отдельности и использования кнопок перемещения вверх и вниз для изменения значения.

При необходимости пользовательского форматирования даты и огра- ничения выделения только одной датой можно использовать элемент управления DateTimePicker вместо MonthCalendar. Если использовать DateTimePicker, необходимость в частых проверках значений да- ты/времени отпадает.

Примечание. Элемент управления DateTimePicker поддерживает только григорианский календарь.

Пример

В приводимом ниже примере производится создание нового экземп- ляра элемента управления DateTimePicker и его инициализация. Свойст- ву CustomFormat элемента управления присвоено значение. Кроме того, свойство ShowCheckBox настроено таким образом, чтобы элемент управ-

ления отображал CheckBox, а свойство ShowUpDown настроено таким образом, чтобы элемент управления отображался как элемент управле- ния «вверх и вниз».

public void CreateMyDateTimePicker()

{

// DateTimePicker dateTimePicker1 = new DateTimePicker();

// Установить минимальную и максимальную даты. dateTimePicker1.MinDate = new DateTime(1985, 6, 20); dateTimePicker1.MaxDate = DateTime.Today;

// Установить строку форматирования dateTimePicker1.CustomFormat = "ddMMMMyyyy     HH:mm:ss"; dateTimePicker1.Format =

System.Windows.Forms.DateTimePickerFormat.Custom;

// Установить CheckBox и высветить ЭУ up-down control. dateTimePicker1.ShowCheckBox = true; dateTimePicker1.ShowUpDown = true;

}

Пример. Создание календаря на 6 месяцев с номерами недель: CalendarDimensions.Width = 3;        // см. 1

CalendarDimensions.Height = 2;

Пример. Чтения даты из календаря monthCalendar1:

DateTime dt = monthCalendar1.SelectionStart;

string дата = dt.Day + "." + dt.Month + "." + dt.Year;

Свойства SelectionStart и SelectionEnd хранят дату в виде объектов структуры DateTime.