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

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

Для этого используется диалог с выбором варианта. Кроме отображения сообщения диалог позволяет получать реакцию пользователя на сообщение за счет добавления кнопок-действий. Набор кнопок может быть произвольным. Для их добавления используется свойство Buttons. Можно воспользоваться набором предопределенных кнопок или добавить свою, если ни одна предопределенная кнопка не подходит.

Если в диалог не добавлены кнопки, в него автоматически добавляются кнопки ОК и Отмена. Предопределенные кнопки не содержат никакой встроенной логики и добавляются с помощью специальных методов Add<тип кнопки>(). Основным их назначением является возможность использования кнопок со стандартными названиями.

Для добавления диалога используйте метод CreateTaskDialog().

Перегрузки

CreateTaskDialog(string text)	Создать диалог с выбором
CreateTaskDialog(string text, MessageType type)	Создать диалог определенного типа MessageType
CreateTaskDialog(string text, string description)	Создать диалог и добавить описание
CreateTaskDialog(string text, string description, MessageType type)	Создать диалог определенного типа MessageType и добавить описание
CreateTaskDialog(string text, string description, MessageType type, string title)	Создать диалог определенного типа MessageType, добавить описание и заголовок

Синтаксис

public static CreateTaskDialog(string text, string description, MessageType type, string title);

Параметры

text – текст сообщения;

description – описание;

type – тип сообщения;

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

Параметр type определяет отображаемую иконку и поведение диалога. Если параметр не указан или имеет значение None, то выводится диалог типа «Информация» (Information).

Если параметр title не указан, то выводится заголовок «Информация».

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

Диалог с пользователем для выбора вариантов действий.

Методы

Имя	Описание
AddHyperlink()	Добавить контрол «Гиперссылка»

Свойства

Имя	Тип	Описание
Buttons	IDialogButtonCollection	Список кнопок диалога

Пример. Создание диалога с выбором

// Создать диалог с пользователем.
var dialog = Dialogs.CreateTaskDialog("Невозможно удалить запись",
                                      "Документ редактируется пользователем",
                                      MessageType.Question,
                                      "Подтверждение");
// Добавить в диалог кнопку «Повторить».
dialog.Buttons.AddRetry();
// Добавить в диалог кнопку «Отмена».
dialog.Buttons.AddCancel();
// Показать диалог.
dialog.Show();

СМ. ТАКЖЕ