ITabSheet.Sparklines

Синтаксис Fore

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

Sparklines: Prognoz.Platform.Interop.Tab.ITabSparklines;

Описание

Свойство Sparklines возвращает коллекцию спарклайнов, отображаемых в таблице.

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

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

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

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

Пример Fore

Для выполнения примера предполагается наличие формы, расположенной на ней кнопки с наименованием «Button1», компонента TabSheetBox с наименованием «TabSheetBox1» и источника данных для «TabSheetBox1».

Sub Button1OnClick(Sender: Object; Args: IMouseEventArgs);
Var
    TSheet: ITabSheet;
    Sparklines: ITabSparklines;
Begin
    TSheet := TabSheetBox1.Source.GetTabSheet;
    Sparklines := TSheet.Sparklines;
    Sparklines.Add(TSheet.ParseRange("A0:A5"), TSheet.ParseRange("B0:F5"));
End Sub Button1OnClick;

При нажатии на кнопку для первых ячеек столбца А будут добавлены спарклайны. Спарклайны будут строиться по данным, которые расположены по строкам в диапазоне «B0:F5».

Пример Fore.NET

Необходимые требования и результат выполнения примера Fore.NET совпадают с примером Fore. Вместо компонентов Fore используйте их Fore.NET аналоги.

Imports Prognoz.Platform.Interop.Tab;

Private Sub button1_Click(sender: System.Object; e: System.EventArgs);
Var
    TSheet: ITabSheet;
    Sparklines: ITabSparklines;
Begin
    TSheet := TabSheetBoxNet1.Source.GetTabSheet();
    Sparklines := TSheet.Sparklines;
    Sparklines.Add(TSheet.ParseRange("A0:A5"), TSheet.ParseRange("B0:F5"));
End Sub;

См. также: