Разработка > Элементы разработки > Модуль > Виджеты > Виджет с диаграммой

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

Диаграмма состоит из значений – отдельных секторов. Для нее настраивается отображение легенды.

Событие «Фильтрация»

Если в настройках диаграммы в поле *Тип действия выбрано значение Показ списка сущностей, то задайте обработчик события Фильтрация. Событие предназначено для фильтрации списка сущностей, который открывается при нажатии на значение диаграммы.

Аргументы события:

•e.ValueId – уникальный идентификатор значения круговой диаграммы. Задается в обработчике события Получение значения.

// При нажатии на сектор открывать список просроченных заданий

// текущего сотрудника.
public virtual IQueryable<Sungero.Workflow.IAssignment> MyTodayAssignmentsChartFiltering(System.Linq.IQueryable <Sungero.Workflow.IAssignment> query, Sungero.Domain.WidgetPieChartFilteringEventArgs e)
{
  // ValueId – идентификатор сектора значения круговой диаграммы.
  if (e.ValueId == OverdueToday)
    return query.Where(a => a.Performer.Equals(Users.Current) && a.Deadline < Calendar.UserNow);
  return query;
}

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

Событие «Получение значения»

Событие предназначено для вычисления значений диаграммы и настройки внешнего вида.

Аргументы события:

•e.Chart.AddValue() – добавление значений круговой диаграммы.

public virtual void GetWidgetChartValue(Sungero.Domain.GetWidgetPieChartValueEventArgs e)
{
  // Добавление значений круговой диаграммы.
  e.Chart.AddValue(valueId1, label1, value1, color1);
  e.Chart.AddValue(valueId2, label2, value2, color2);
}

Содержит параметры:

valueId – уникальный идентификатор значения круговой диаграммы. Используется в событиях Фильтрация и Выполнение. Рекомендуется задавать в константах модуля. Тип параметра – строка.

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

value – значение, которое отображается рядом с сектором. Тип параметра – число.

color – настройка цвета для сектора круговой диаграммы. Параметр необязательный. Тип параметра – цвет.

•e.Chart.DisplayValueFormat – формат значения, которое отображается рядом сектором. Например, единицы измерения, проценты.

// Числовое значение рядом с сектором будет отображаться в процентах.
e.Chart.DisplayValueFormat = {"0:P"};

Подробнее см. в статьях Microsoft «Строки стандартных числовых форматов» и «Строки настраиваемых числовых форматов».

•e.Chart.IsLegendVisible – отображение легенды для диаграммы. По умолчанию отображается.

// Отключить отображение легенды.
e.Chart.IsLegendVisible = false;

public virtual void GetMyTodayAssignmentsChartValue (Sungero.Domain.GetWidgetPieChartValueEventArgs e)
{
  var assignments = Workflow.Assignments.GetAll();
  // Добавление сектора с просроченными заданиями.
  var overdue = Functions.Module.GetMyTodayAssignments(assignments, _parameters.Substitution, Constants.Module.OverdueToday).Count();
  if (overdue != 0)
    e.Chart.AddValue(Constants.Module.OverdueToday, Resources.WidgetMTAOverdue, overdue, Colors.Charts.Red);
  // Добавление сектора с заданиями, которые нужно выполнить сегодня.
  var deadline = Functions.Module.GetMyTodayAssignments(assignments, _parameters.Substitution, Constants.Module.DeadlineToday).Count();
  if (deadline != 0)
    e.Chart.AddValue(Constants.Module.DeadlineToday, Resources.WidgetMTADeadline, deadline, Colors.Charts.Color1);
  // Добавление сектора с заданиями, которые нужно выполнить до послезавтра.
  var after = Functions.Module.GetMyTodayAssignments(assignments, _parameters.Substitution, Constants.Module.AfterToday).Count();
  if (after != 0)
    e.Chart.AddValue(Constants.Module.AfterToday, Resources.WidgetMTAAfter, after, Colors.Charts.Color6);
  // Добавление сектора с заданиями, которые выполнены сегодня.
  var completed = Functions.Module.GetMyTodayAssignments(assignments, _parameters.Substitution, Constants.Module.CompletedToday).Count();
  if (completed != 0)
    e.Chart.AddValue(Constants.Module.CompletedToday, Resources.WidgetMTACompleted, completed, Colors.Charts.Green);
}

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

Событие «Выполнение»

Если в настройках диаграммы в поле *Тип действия выбрано значение Разрабатываемое, то задайте обработчик события Выполнение. Событие предназначено для задания логики, которая выполняется при нажатии на значение диаграммы.

Аргументы события:

public virtual void ExecuteMyTodayAssignmentsChart(Sungero.Domain.Client. ExecuteWidgetPieChartActionEventArgs e)
{
  // При нажатии на сектор «Выполнить сегодня»

  // выполнится функция MyTodayAssignments()
  if (e.ValueId == Constants.Module.CompletedToday)
    Functions.Module.MyTodayAssignments(_parameters.Performer);
}

СМ. ТАКЖЕ

Круговая диаграмма

Круговая диаграмма