Delphi 3 и создание приложений баз данных


13.4.1.Свойства компонента 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 и используются для вертикальной оси.




- Начало -  - Назад -  - Вперед -