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

Метод используется для добавления контрола «Многострочный текст» в диалог.

Перегрузки

AddMultilineString(string title, bool isRequired)	Добавить контрол «Многострочный текст»
AddMultilineString(string title, bool isRequired, string defaultValue)	Добавить контрол «Многострочный текст», указать, является ли он обязательным для заполнения, и указать значение по умолчанию

Синтаксис

C#
public IMultilineStringDialogValue AddMultilineString(string title, bool isRequired, string defaultValue);

Параметры

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

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

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

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

Контрол «Многострочный текст» (IMultilineStringDialogValue).

IMultilineStringDialogValue

Методы

Имя	Описание
MaxLength(int length)	Задать максимально разрешенную длину строки. Параметр: lenght – длина строки. Возвращаемое значение: контрол «Многострочный текст»
WithRowsCount(int count)	Задать высоту контрола. По умолчанию контрол имеет высоту 6 строк. Параметр: count – высота контрола в строках. Возвращаемое значение: контрол «Многострочный текст»
SetOnValueChanged()	Задать обработчик, который выполняется при изменении контрола
WithLabel(string label)	Установить текстовую метку для контрола. Параметр: label – текст метки. Возвращаемое значение: контрол «Многострочный текст»
WithPlaceholder(string text)	Добавить текст подсказки в контрол. Параметр: text – текст подсказки. Возвращаемое значение: контрол «Многострочный текст»

Свойства

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

Пример. Диалог для оформления пожелания

/// <summary>
/// Показать диалог с контролом «Многострочный текст».
/// </summary>
public virtual void ShowMyDialog()
{
  var dialog = Dialogs.CreateInputDialog("Пожелание к процессу");
  // Добавить контрол «Дата» с текстовой меткой-подсказкой.
  var WishDateControl = dialog.AddDate("Срок для ответа на пожелание", false).WithLabel("- заполняется автоматически");
  //Добавить контрол «Многострочный текст» и задать высоту для ввода текста – 9 строк.
  var ms1 = dialog.AddMultilineString("Описание ситуации", false).WithRowsCount(9);
  // После заполнения контрола, заполнить "Срок для ответа на пожелание".
  ms1.SetOnValueChanged((x)=> 
  {
    if (x.NewValue != null)
    {
      WishDateControl.Value = Calendar.Today.NextWorkingDay();
    }
  });
  //Добавить контрол «Многострочный текст». Высота контрола явно не указана, поэтому значение по умолчанию 6 строк.
  var ms2 = dialog.AddMultilineString("Последствия", false);
  //В контрол можно ввести текст длиной <=255 симовлов.
  ms2.MaxLength(255);
 
  dialog.Show();
}

AddMultilineString – многострочный текст

AddMultilineString – многострочный текст