Основные свойства компонента Chart

Прежде, чем рассматривать некоторые настройки компонентов Chart полезно коротко остановиться на некоторых свойствах, объектах и классах, опи­сывающих эти компоненты. Дело в том, что описание этих компонентов довольно сложное и в нем нетрудно запутаться. Для того чтобы сделать обозримым все это множество свойств, в данном разделе даются некоторые справочные сведения. Подробное рассмотрение отдельных свойств дается в последующих разделах.

Компонент Chart имеет множество свойств. Основными с точки зрения применения данного компонента можно считать следующие.

AllowPanning – Управляет возможностью пользователя прокручивать график. Возможные значения: pmNone — прокручивание запрещено, pmHorizontal — разрешена горизонтальная прокрутка, pmVertical — раз­решена вертикальная прокрутка, pmBoth — разрешена прокрутка в обоих направлениях (по умолчанию pmBoth).

AllowZoom :boolean – Разрешает или запрещает описанную ранее возможность пользователя изменять масштаб графика

AnimatedZoom:boolean – Определяет, будет ли увеличение размера выполняться плавно (при значении true), или скачком

AnimatedZoomSteps – Число шагов постепенного изменения масштаба

AxisVisible – Определяет видимость координатных осей

Backlmage – Изображение на фоне поля графика — объект класса TPicture

BackWall, BottomWall, LeftWall – Это объекты класса TChartWall, описывающие при трехмерном изображении соответственно заднюю, нижнюю и левую стенки (только при View3d = true и View3dWalls = true)

BottomAxis – Координатные оси.

DepthAxis, LeftAxis, RightAxis, TopAxis – Это объекты класса TChartAxis: множество атрибутов определяющих координатную ось направленную вглубь, левую ось, правую, верхнюю.

Canvas – Канва, на которой формируется изображение. Это не обычная канва, присущая многим компонентам Delphi. Точнее, ее можно использовать и как обычную канву класса TCanvas, и как трехмерную канву класса ТСаnvas3D, обладающую множеством методов рисования трехмерных изображений

Chart3dPercent – Относительный (в процентах) масштаб третьего измерения

в трехмерном изображении

Foot, Title – Объекты класса TChartTitle, описывающие подпись и заголовок графика

Legend – Легенда (список обозначений) — объект класса TChartLegend

MarginLeft, MarginTop, MarginRight, MarginBottom – Левое, верхнее, правое и нижнее поля графика

MaxPointsPerPage Число точек на страницу. По умолчанию 0 — это значит, что все данные представлены на одной странице. При за­дании положительного значения MaxPointsPerPage все данные делятся на страницы с заданным числом точек. Навигация по страницам осуществляется с помощью свой­ства Page и методов NumPages, PreviousPage и NextPage

Page – Определяет текущую страницу при значении MaxPointsPerPage > О

ScaleLastPage – При значении true масштаб последней страницы (см описание MaxPointsPerPage) такой же, как и предыдущих. При значении false изображение на последней странице растягивается по оси аргументов, чтобы заполнить всю площадь графика

Series – Индексированный список серий — объектов класса TChartSeries и его наследников

SeriesList – Индексированный список, определяющий размещение серий по оси Z, направленной вглубь. Эта последователь­ность указывает, какая серия рисуется поверх другой и какая серия размещается ближе, а какая дальше при j трехмерном изображении

View3d – Обеспечивает трехмерный, или плоский характер изображения

View3DOptions – Объект класса TView3DOptions, содержащий свойства перестроения трехмерного изображения

View3dWalls – Разрешает рисование левой и нижней стенок при трехмерном изображении

В табл. 1 приведен список основных методов класса TChart.

Таблица 1. Основные методы класса TChart

ChartPreview Вызов диалога предварительного просмотра перед печатью

ChartXCenter, Возвращают координаты соответственно середины гори-

ChartYCenter зонтальной и вертикальной осей

CopyToCIipboardBitmap- Копируют изображение в буфер обмена Clipboard в фор- CopyToClipboardMetafile матах .bmp, .wmf, .emf

GetCursorPos Возвращает позицию курсора в пикселах типа TPoint, пе-

ресчитанную в систему координат поля графиков

LoadChartFromFile Загружает изображение из указанного файла. Это может быть

файл, ранее сохраненный методом SaveChartToFile

MaxXValue, Возвращают минимальные и максимальные значения со-

MaxYValue, ответствующих указанным в вызове координатным осям

MinXValue,

MinYValue

NumPages, Общее число страниц (см. описание MaxPointsPerPage)

PreviousPage, и переход к предыдущей и следующей страницам. Previo-

NextPage usPage эквивалентно Page -1 (см. Page в табл. 7.1). NextPage

эквивалентно Page +1

PrintLandscape, Методы печати

PrintPortrait,

PrintPartialCanvas,

PrintPartial,

PrintRect, Print

SaveChartToFile Сохраняет изображение в файле с указанным именем.

В дальнейшем он может быть загружен методом LoadChartFromFile

SaveToBitmapFile Сохраняет изображение в файле .bmp с указанным именем

SaveToMetafile Сохраняет изображение в метафайле с указанным именем

Например: Chart1.SaveToMetafile( 'c:\mychart.wmf' )

SaveToMetafileEnh Сохраняет изображение в метафайле Enhanced WMF с

указанным именем

ZoomRect, Методы изменения масштаба

ZoomPercent,

UndoZoom

Графики и диаграммы, которые отображаются в компоненте TChart, содержатся в объектах Series типа TChartSeries. Остановимся на основных свойствах класса TChartSeries.

Active Указывает, является ли серия активной

Count Число точек серии

ColorEachPoint При значении true каждая точка или интервал графика меж­ду соседними точками окрашивается в свой цвет, который берется из массива ValueColor

Cursor Вид, который приобретает курсор мыши, перемещающийся

над точкой данной серии

SeriesColor Цвет серии по умолчанию. (при добавлении точек методами Add

можно задать другой цвет

ShowInLegend Определяет, должна ли серия отображаться в легенде

Title Название серии (может быть написано кириллицей). Исполь-

зуется при отображении в легенде