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

Линейный график состоит из нескольких серий и значений, которые представляют собой отдельные точки (x,y) на линии. При нажатии на значение графика появляется подсказка.

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

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

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

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

•e.Chart.AddNewSeries() – добавление серии линейного графика.

public virtual void GetWidgetChartValue(Sungero.Domain.GetWidgetPlotChartValueEventArgs e)

{
  // Добавление новой серии.
  var series1 = e.Chart.AddNewSeries(title, color);
}

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

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

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

•series1.AddValue() – добавление значений серии линейного графика.

public virtual void GetWidgetChartValue(Sungero.Domain.GetWidgetPlotChartValueEventArgs e)

{
  // Создание серии.
  var series1 = e.Chart.AddNewSeries(title, color);
  // Заполнение серии значениями.
  series1.AddValue(valueX1, valueY1);
  series1.AddValue(valueX2, valueY2);
  series1.AddValue(valueX3, valueY3);
}

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

valueX – координата точки на линии по оси X. Тип параметра – дата и время или число.

valueY – координата точки на линии по оси Y. Тип параметра – число.

•e.Chart.Axis.X.AxisType – тип оси: дата (DateTime) или число (Double).

Важно. Если указан тип оси DateTime, то в методе AddValue() параметр valueX необходимо задавать в том же формате DateTime.

•e.Chart.Axis.X.Title – подпись к оси X;

•e.Chart.Axis.Y.Title – подпись к оси Y;

•e.Chart.Axis.Y.MaxValue – максимальное значение по оси Y. Если значение будет больше указанного, то график обрежется;

•e.Chart.Axis.Y.MinValue – минимальное значение по оси Y. Если значение будет меньше указанного, то график обрежется.

примечание. Если значения MaxValue или MinValue не указаны, то добавляется отступ вверх от максимального значения графика или вниз от минимального значения. Значение отступа рассчитывается как 10% от разницы максимального и минимального значения.

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

Обработчик события «Получение значения» виджета «Динамика количества заданий»

public virtual void GetActiveAssignmentsDynamicAssignmentsDynamicChartValue(Sungero.Domain.GetWidgetPlotChartValueEventArgs e)

{
  if (!Equals(_parameters.CarriedObjects,  Widgets.ActiveAssignmentsDynamic.CarriedObjects.All) && Users.Current.IsSystem == true)
    return;
  // Получение точек на графике виджета.
  var points = Docflow.PublicFunctions.Module.GetActiveAssignmentsDynamicPoints(businessUnitIds, departmentsIds, employee, periodBegin, periodEnd, unwrap, needFilter);
  if (!points.Any())
    return;
  // Тип оси X – дата.
  e.Chart.Axis.X.AxisType = AxisType.DateTime;
  // Подпись к оси Y. Берется из ресурсов модуля.
  e.Chart.Axis.Y.Title = Resources.WidgetActiveAssignmentsDynamicYAxisTitle;
  // Создание первой серии.
  var assignmentsInWork = e.Chart.AddNewSeries(Resources.WidgetActiveAssignmentsDynamicSeriesAllTitle, Colors.Charts.Color1);
  // Создание второй серии.
  var overdueAssignmentsInWork = e.Chart.AddNewSeries(Resources.WidgetActiveAssignmentsDynamicSeriesOverduedTitle, Colors.Charts.Red);
  var maxValue = points.Select(p => p.ActiveAssignmentsCount).Max();
  var minValue = points.Select(p => p.ActiveOverdueAssignmentsCount).Min();
  // Заполнение первой и второй серии значениями.
  foreach (var point in points)
  {
    assignmentsInWork.AddValue(point.Date, point.ActiveAssignmentsCount);
    overdueAssignmentsInWork.AddValue(point.Date, point.ActiveOverdueAssignmentsCount);
  }
  // Округление значений по оси Y.
  if (minValue > Math.Round(maxValue * 0.1))
    e.Chart.Axis.Y.MinValue = Math.Round(minValue * 0.95);
  else
    // Минимальное значение по оси Y.
    e.Chart.Axis.Y.MinValue = 0;
    // Максимальное значение по оси Y.
    e.Chart.Axis.Y.MaxValue = Math.Round(maxValue * 1.05);
}

СМ. ТАКЖЕ