Объектная модель > Основные механизмы > Dialogs – диалоги > CreateInputDialog – создать диалог с запросом параметров > AddDate

Метод используется для добавления контрола «Дата» в диалог. По умолчанию устанавливается формат «Дата со временем».
При необходимости, с помощью методов можно изменить формат даты.

Перегрузки

AddDate(string title, bool isRequired)	Добавить контрол «Дата»
AddDate(string title, bool isRequired, Nullable<DateTime> defaultValue)	Добавить контрол «Дата», указать, является ли он обязательным для заполнения, и указать значение по умолчанию

Синтаксис

public IDateDialogValue AddDate(string title, bool isRequired, Nullable<DateTime> defaultValue);

Параметры

title – заголовок контрола;

isRequired – признак того, что контрол является обязательным для заполнения;

defaultValue – значение по умолчанию.

Возвращаемое значение

Контрол «Дата» (IDateDialogValue).

IDateDialogValue

Методы

Имя	Описание
AsDateTime()	Установить формат «Только дата». Возвращаемое значение: контрол ввода для дат. По умолчанию устанавливается формат «Дата со временем»
AsMonthYear()	Установить формат «Год и месяц». Возвращаемое значение: контрол «Дата»
AsYear()	Установить формат «Только год». Возвращаемое значение: контрол «Дата»
SetOnValueChanged()	Задать обработчик, который выполняется при изменении контрола
WithLabel(string label)	Установить текстовую метку для контрола. Параметр: label – текст метки. Возвращаемое значение: контрол «Дата»
WithPlaceholder(string text)	Добавить текст подсказки в контрол. Параметр: text – текст подсказки. Возвращаемое значение: контрол «Дата»

Свойства

Имя	Тип	Описание
IsEnabled	bool	Признак того, что контрол доступен
IsLabelVisible	bool	Признак того, что текстовая метка является видимой
IsRequired	bool	Признак того, что контрол обязателен для заполнения
IsVisible	bool	Признак того, что контрол является видимым
Value	Nullable<DateTime>	Значение контрола

Пример 1. Задание формата даты

// Формат «Только год».
var date = dialog.AddDate("Год открытия", true).AsYear();
// Формат «Год и месяц».
var date = dialog.AddDate("Отчетный месяц", true).AsMonthYear();
// Формат «Только дата».
var date = dialog.AddDate("Дата создания", true).AsDateTime();

Пример 2. Диалог с запросом параметров для отчета

public override void BeforeExecute(Sungero.Reporting.Client.BeforeExecuteEventArgs e)
{
  // Запросить параметры отчета.
  var dialog = Dialogs.CreateInputDialog("Параметры отчета");
  var startDate = dialog.AddDate("Начальная дата", true, Calendar.Today.AddDays(-180));
  var endDate = dialog.AddDate("Конечная дата", true, Calendar.Today);
 
  if (dialog.Show() != DialogButtons.Ok)
    e.Cancel = true;
  // Передать заполненные значения в параметры отчета.
  TasksWithAttachments.StartDate = startDate.Value.Value;
  TasksWithAttachments.EndDate = endDate.Value.Value;
}