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

Для предотвращения ошибок при выполнении действий в системе используются диалоги подтверждения. Например, если сотрудник случайно нажал на кнопку выполнения задания, то задание выполнится не сразу, а прежде отобразится диалог подтверждения действия:

Диалог появляется, если в редакторе типа сущности для действия или результата выполнения установлен флажок Запрашивать подтверждение перед выполнением. Диалог может отображаться с флажком Больше не спрашивать или без него. За отображения флажка отвечает параметр Позволить пользователю отключать подтверждение.

Для программного создания диалога подтверждения используется метод CreateConfirmDialog(), который доступен только в клиентском коде.

Перегрузки

CreateConfirmDialog(string text)	Создать диалог подтверждения
CreateConfirmDialog(string text, string description)	Создать диалог подтверждения и добавить описание
CreateConfirmDialog(string text, string description, string title)	Создать диалог подтверждения, добавить описание и заголовок

Синтаксис

public static IConfirmDialog CreateConfirmDialog(string text, string description, string title);

Параметры

text – текст вопроса;

description – описание;

title – заголовок.

ПРИМЕЧАНИЕ. В зависимости от перегрузки количество параметров может изменяться.

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

Диалог подтверждения (IConfirmDialog).

IConfirmDialog

Методы

Имя	Описание
Show()	Показать диалог подтверждения. Возвращаемое значение: результат диалога подтверждения (True или False)
WithDontAskAgain(string dialogId)	Добавить в диалог флажок Больше не спрашивать. Параметр: dialogId – прикладной идентификатор диалога для сохранения значения флажка, которое выбрал пользователь. Если идентификатор пустой, то флажок не отображается. Возвращаемое значение: диалог подтверждения

Имя

Описание

Show()

Показать диалог подтверждения. Возвращаемое значение: результат диалога подтверждения (True или False)

WithDontAskAgain(string dialogId)

Добавить в диалог флажок Больше не спрашивать. Параметр: dialogId – прикладной идентификатор диалога для сохранения значения флажка, которое выбрал пользователь. Если идентификатор пустой, то флажок не отображается. Возвращаемое значение: диалог подтверждения

Пример

// Создать диалог подтверждения.
bool isConfirmed = Dialogs.CreateConfirmDialog("Уверены?", "Описание").Show();
 
// Создать диалог подтверждения с флажком "Больше не спрашивать".
const string MY_DIALOG_ID = "1062d029-6d4f-4612-822f-e3c02d5bfe28";
bool isConfirmed = Dialogs.CreateConfirmDialog("Уверены?", "Описание", "Заголовок").WithDontAskAgain(MY_DIALOG_ID).Show();

CreateConfirmDialog – диалог подтверждения

CreateConfirmDialog – диалог подтверждения