IChartStyleAbsoluteGroup.Add

Синтаксис Fore

Add(SerieIdx: Integer; ToTheBeginning: Boolean): Integer;

Синтаксис Fore.NET

Add[SerieIdx: integer; ToTheBeginning: boolean]: integer;

Параметры

SerieIdx. Абсолютный индекс ряда;

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

Описание

Метод Add удаляет указанный ряд из относительной группы, к которой он принадлежит. Затем создаёт новую относительную группу и добавляет этот ряд в неё. После этого метод возвращает индекс созданной группы.

Комментарии

Метод устарел, используйте IChartStyleRelativeGroup.Move и IChartStyleRelativeGroup.MoveTo.

Абсолютный индекс ряда это порядковый номер указанного ряда среди всех рядов диаграммы.

Относительная группа формируется суммированием значений рядов. Итоговая диаграмма в этом случае выглядит следующим образом:

Пример Fore

Для выполнения примера понадобится форма с расположенными на ней компонентами UiChart, ChartBox и Button с идентификаторами «UiChart1», «ChartBox1» и «Button1» соответственно. Компонент «UiChart1» должен являться источником данных для компонента «ChartBox1» и в нём для диаграммы должен быть установлен тип шкалы «Смешанный».

Пример является обработчиком события для кнопки.

Sub Button1OnClick(Sender: Object; Args: IMouseEventArgs);
Var
    Chart: IChart;
    ChartS: IChartStyleAbsoluteGroup;
    SerieC: IChartSerie;
    RIndex: Integer;
Begin
    Chart := ChartBox1.Chart;
    Chart.Style := ChartStyle.Mixed;
    ChartS := Chart.StyleGroup;
    SerieC := Chart.Series.Item(0);
    RIndex := ChartS.RelativeIndexOf(SerieC);
    ChartS.Add(RIndex, True).ToString;
End Sub Button1OnClick;

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

Пример Fore.NET

Для выполнения примера понадобится форма с расположенными на ней компонентами UiChartNet, ChartBoxNet и Button с идентификаторами «UiCharNett1», «ChartBoxNet1» и «Button1» соответственно. Компонент «UiChartNet1» должен являться источником данных для компонента «ChartBoxNet1» и в нём для диаграммы должен быть установлен тип шкалы «Смешанный».

Пример является обработчиком события для кнопки.

Imports Prognoz.Platform.Interop.Chart;
...
Sub button1_Click(sender: System.Object; e: System.EventArgs);
Var
    Chart: IChart;
    ChartS: IChartStyleAbsoluteGroup;
    SerieC: IChartSerie;
    RIndex: Integer;
Begin
    Chart := ChartBoxNet1.CtrlBox.Chart;
    Chart.Style := ChartStyle.chsMixed;
    ChartS := Chart.StyleGroup;
    SerieC := Chart.Series.Item[0];
    RIndex := ChartS.RelativeIndexOf[SerieC];
    ChartS.Add(RIndex, True).ToString();
End Sub;

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

См. также:

IChartStyleAbsoluteGroup