Точки графика – класс TChartValueList

График TChartSeries – это сердце диаграммы. Визуально он может быть представлен в виде обычной линии, заштрихованной области, пирамиды, цилиндра или чего-либо еще. Линия графика строится по его точкам. Для хранения точек в рамках класса создано специальное хранилище – список точек:

propertyValueList[Index : Longint] : TChartValueList;

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

propertyXValues : TChartValueList; //значения по оси X

propertyYValues : TChartValueList; //значения по оси Y

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

propertyValue[Index : Longint] : Double;

Например:

LineSeries1.YValues.Value[5] := 25 ;

LineSeries1.Repaint;

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

propertyXValue[Index : Longint] : Double; //значение по оси X

propertyYValue[Index : Longint] : Double; //значение по оси Y

propertyXLabel[Index : Longint] : String; //метка – пояснительная подпись к

точке

Здесь Index – порядковый номер точки. Общее количество элементов в хранилище возвратит функция:

functionCount : Longint;

Существует ряд свойств и методов графика, несущих исключительно информационную нагрузку (табл. 18.1).

Таблица 18.1. Информационные свойства графика

Для облегчения поиска точки по ее значению создана функция:

functionLocate (constValue : Double) : Longint;

В случае успеха метод возвратит индекс найденной точки в наборе. Если такой точки не существует, то функция вернет –1.

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