Метки графика – класс TSeriesMarks

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

Визуально метка состоит из цветного прямоугольника с текстовой строкой на нем.

Рис. 18.5. Метки графика

Общая настройка всех меток графика обеспечивается свойством:

propertyMarks : TSeriesMarks;

Самое коварное, что может сделать TSeriesMarks, – так это отключить вывод меток на экран. Для этого надо установить в false свойство:

propertyVisible : Boolean;

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

propertyStyle : TSeriesMarksStyle;

TSeriesMarksStyle = (smsValue, smsPercent, smsLabel, smsLabelPercent, smsLabelValue, smsLegend, smsPercentTotal, smsLabelPercentTotal, smsXValue);

В зависимости от выбранного стиля в тексте метки окажется: только числовое значение точки, значение в процентах, описание. По умолчанию назначается стиль smsLabel. При этом текст метки будет идентичен тексту подписи данной точки по горизонтальной оси X диаграммы. А если в нашем примере с населением Северной и Южной Америк установить стиль меток в smsLabelPercent:

WithBarSeries.Marks do

Begin

Visible:=True;

Style:=smsLabelPercent;

end;

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

propertyArrow : TChartPen;

Длина соединительной линии (измеряется в пикселах) устанавливается в свойстве:

propertyArrowLength : Integer;

Особенности прорисовки границ прямоугольной области метки задаются в свойстве:

propertyFrame : TChartPen;

Цвет фона метки определяется значением свойства:

propertyBackColor : TColor;

Вместо заливки цветом при желании можно сделать метки прозрачными. Для этого надо передать значение true в свойство:

propertyTransparent : Boolean;

Шрифт метки определяется в свойстве:

propertyFont : TFont;

Свойство Clip контролирует, чтобы метки не выходили за пределы рабочей области. Если свойство установлено в true, метки отсекаются.

propertyClip : Boolean;

Единственный метод, объявленный у класса TSeriesMarks, преобразует экранные координаты в индекс метки:

propertyClicked(X, Y : Integer):Integer ;

Все перечисленные свойства доступны в Инспекторе объектов и на вкладке Marks встроенного редактора диаграммы (рис. 18.6).

Рис. 18.6. Страница оформления меток диаграммы