Разработка > Примеры разработки > Виджеты > Как добавить параметр-перечисления

Предположим, разрабатывается виджет «Мои используемые документы» с действиями «Все время», «Сегодня» и «Вчера». Необходимо, чтобы у пользователя была возможность выбирать, какие данные будут отображаться в действиях виджета:

•только по документам, открытым на просмотр;

•только по документам, открытым на редактирование;

•по всем документам.

В этом случае добавьте для виджета параметр-перечисление с возможными значениями Просмотренные, Измененные и Все. Для этого:

1.В редакторе модуля перейдите в узел «Виджеты» и создайте параметр-перечисление.

2.В списке элементов выделите добавленный элемент и задайте настройки параметра.

3.Добавьте возможные значения параметра. Для этого в поле для ввода укажите имя значения.

4.Нажмите на кнопку . В табличной части будет создана новая запись. В колонке *Имя будет указанно введенное значение.

5.В колонке *Отображаемое имя введите имя значения, которое будет отображаться в проводнике системы. Для локализации отображаемого имени перейдите по ссылке Локализовать.

6.Чтобы данные в действиях виджета фильтровались в зависимости от значения параметра, задайте обработчик события Фильтрация. Для этого в списке элементов выделите элемент Items и выберите действие «Все время». Установите флажок Фильтрация и перейдите по ссылке. Откроется редактор программного кода.

Аналогичным образом задайте обработчик события Фильтрация для действий «Сегодня» и «Вчера».

Примечание. В зависимости от типа действия виджета для него могут быть доступны обработчики событий Получение значения и Выполнение.

/// <summary>
/// Формирование списка документов, который отображается
/// при нажатии на действие "Все время".
/// </summary>
public virtual IQueryable<Sungero.Content.IElectronicDocument> WidgetAllTimeFiltering(IQueryable<Sungero.Content.IElectronicDocument> query)
{
  // Если для параметра-перечисления "Показывать документы" установлено
  // значение "Просмотренные", то в виджете отображается информация
  // по документам, которые пользователь открывал на просмотр.
  if (_parameters.Show == Docflow.Widgets.Widget.Show.Read)
    query = query.WhereDocumentHistory(h => h.Action == Sungero.CoreEntities.History.Action.Read);
  // Если для параметра-перечисления "Показывать документы" установлено
  // значение "Измененные", то в виджете отображается информация
  // по документам, которые пользователь открывал на редактирование.
  if (_parameters.Show == Docflow.Widgets.Widget.Show.Update)
    query = query.WhereDocumentHistory(h => h.Action == Sungero.CoreEntities.History.Action.Update);
  // Если для параметра-перечисления "Показывать документы" установлено
  // значение "Все" и для логического параметра
  // "Учитывать документы без содержимого" установлено значение False,
  // то в виджете отображается информация по всем документам
  // которые открывал пользователь.
  return query
    .WhereDocumentHistory(h => Equals(Users.Current, h.User))
    .Where(d => IsOftenUsed(d));
}

В результате для виджета «Мои используемые документы» будет добавлен параметр-перечисление:

В зависимости от значения параметра, которое указал пользователь, в действиях виджета будут отображаться данные по всем документам, только по документам, которые были открыты на просмотр или на редактирование.

СМ. ТАКЖЕ