Свойства компонента TChartSeries
property Active : Boolean; - активизирует (показывает) серию в графике (значение True) и дезактивизирует (скрывает) серию (False). Например: DBChartl.Series[0].Active :=True;
property DataSource : TComponent; -
ссылается на компонент типа НД (TTable, TQuery, TClientDataSet) или на другую серию, откуда берутся данные для показа в серии. Например: DBChartl.Series[0].DataSource := Query2;property HorizAxis: THorizAxis; -
указывает, какая горизонтальная ось будет использована для серии. Значения: aTopAxis • верхняя горизонтальная ось; aBottomAxis - нижняя горизонтальная ось.property Marks : TSeriesMarks; -
описывает свойства марок серии, т.е. значений в прямоугольниках, рисуемых для каждого значения серии. Свойства объекта Marks:property Arrow : TChartPen; -
задает свойства пера, рисующего марку. Свойства объекта Arrow:property Color: TColor; -
цвет линий;property Mode: TPenMode; -
способ рисования линий;property Style: TPenStyle; -
стиль линий;property Visible: Boolean; -
видимость линий;property Width: Integer; -
задает ширину линий;property ArrowLength : Integer; -
длина в пикселях линии, соединяющей марку с соответствующим изображением элемента серии. По умолчанию 16;property BackColor: TColor; -
определяет цвет фона марки. По умолчанию $80FFFF (желтый);property Clip: Boolean; -
если содержит True, марки не могут накладываться на другие элементы графика (на легенду, метки осей и т.д.);property Font : TFont; -
определяет шрифт, которым выводится информация внутри марки;property ParentSeries : TChartSeries; -
содержит указатель на серию, к которой принадлежат марки;property Style : TSeriesMarksStyle; -
определяет содержимое марки. По умолчанию smsLabel. В обработчике события TChartSeries. OnGetMarkText можно переопределить значения, принятые по умолчанию. Например: DBChartl.Series[0].Style := smsLabelValue;Возможные значения свойства Style:
• smsValue -
значения по осиУ (YValue), за исключением THorizBarSeries (XValue). Например, "9087";• smsPercent - процентное значение, например "44%"; для форматирования процентного значения также используется свойство TChartSeries. PercentFormat;
• smsLabel -
показывает метку, ассоциированную с точкой графика, например "Сахарный песок" (при построении графика продаж по товарам); в том случае, если метки со значениями не ассоциированы, в марках выводятся сами значения;• smsLabelPercent -
показывает метку и процентное значение, например "Сахарный песок 44%";• smsLabelValue -
показывает метку и значение, например "Сахарный песок 9087";• smsLegend -
показывает один из элементов легенды графика, список возможных значений доступен через свойство TChartLegend. TextStyle;• smsPercentTotal -
показывает процентное значение и общую сумму, от которой оно взято, например "44% от 20563".• smsLabelPercent Total -
показывает метку, процентное число и общую сумму, например "Сахарный песок 44% от 20563";• smsXValue •
показывает значение по оси Х (XValue), например "01.02.1997";• property Transparent: Boolean; -
значение True определяет, что цвет фона марки не используется (в качестве фона используется "прозрачный цвет"); по умолчанию False;property Visible : Boolean;
-определяет, видимы ли (True) или нет (False) марки на графике.property ParentChart : TCustomChart; -
указывает компонент TDBChart, к которому принадлежит серия. Изменение этого свойства позволяет во время выполнения добавлять в график новые серии, показывать серии в других графиках. Например:var
MySeries : TBarSeries;
MySeries := TBarSeries.Create(Self);
MySeries.ParentChart := DBChartI;
property PercentFormat : String; -
определяет формат показа процентных значений;property RecalcOptions: TSeriesRecalcOptions; -
указывает перечень событий, приводящих к пересчету значений серии ( учитывается только для серий, свойство DataSource которых указывает на другую серию) по умолчанию [rOnDelete, rOnModify, rOnInsert, rOnClear],property SeriesColor: TColor; -
определяет цвет, которым выводятся значения серии в графике. Например:DBChartI.Series[0].SeriesColor := clBlue;
property ShowInLegend: Boolean; -
определяет, показывать ли (True) легенду или нет (False). по умолчанию True;property Title: String; -
определяет заголовок серии; по умолчанию заголовок отсутствует, но он может быть назначен в редакторе графика (кнопка Title в окне Series). Например: DBChart1.Series[0].Title := Edit1.Text;property ValueColor[Index:LongInt]:TColor;
- массив, определяет цвет элемента серии с номером Index, например, DBChart1.Series[0].ValueColor[2] := clAqua;property ValueFormat: String; -
определяет формат показа значений серии; при прорисовке осей используется для форматирования меток, при прорисовке серии используется для форматирования значений, показываемых в марках;property ValueMarkTextlIndex:Longint]:String; -
массив значений, выводимых в марках серии;property VertAxis : TVertAxis; -
определяет местоположение вертикальной оси - слева на графике (aLeftAxis) или справа (aRightAxis);property XLabel[Index:LongInt]: String; -
массив, хранящий метки серии по оси X; Index должен находиться в диапазоне 0. Count -1;DBChartI.Series[0].XLabel[2] := Edit2.Text; property XLabelsSource: String; - имя поля НД (или иного источника значений для серии), определяемого в свойстве DataSource. Содержимое этого поля служит для отображения значений по оси X. Поле должно быть типа, к которому применяется метод AsString. Если значение свойства опущено, значения по оси Х не выводятся. Например: DBChartI.Series [0].XLabelsSource := 'MES';
property XValue[Index:LongInt] : Double;
- возвращает значение в списке XValues (см. ниже) с индексом Index (значение в диапазоне 0. Count -1).property XValues:TChartValueList; -
хранит значения серии по оси X. Значения из этого списка НЕЛЬЗЯ удалять, добавлять и т.д. напрямую. Для этого следует воспользоваться соответствующими методами компонента TChartSeries. Могут быть полезны следующие свойства TCliart ValueList:• property Valuel Index:LongInt |: Double; -
обеспечивает доступ к элементу серии с индексом Index (значение в диапазоне 0. Count -1). Например:DBChart1.Series[0].YValues.Value[2] := StrToFloat(Edit3.Text) ;
DBChart1.Series[0].Repaint;
• property ValueSource : String; -
указывает источник данных для формирования значений по оси X. В зависимости от того, каков источник данных для серии (свойство DataSource компонента TChartSeries), может содержать:1) имя поля - числового типа, типа даты, времени, даты и времени; в этом случае свойство серии DataSource должно ссылаться на НД (TTable, TQuery, TClientDataSet), например:
DBChart1.Series[0].DataSource := Query2;
DBChart1.Series[0].XValues.ValueSource := 'Pole1';
при этом необходимо помнить, что данные будут взяты в серию только из открытого НД; если НД закрыт, то получение данных будет отложено до открытия НД;
2) имя существующего TChart ValueList из другой серии; в этом случае свойство DataSource серии должно ссылаться на другую серию, например:
DBChart1.Series[0].DataSource := DBChart2.Series [4] ;
DBChart1.Series[0].XValues.ValueSource := 'X';
Свойства property YValuetIndex:LongInt]: Double; property YValues: TChartValueList; аналогичны свойствам XValue и XValues и используются для вертикальной оси.
