Объект «Диаграмма» — основные принципы и понятия, используемые при визуальной настройке и управлении

Диаграмма представляет собой определенную фигуру, которая строится на основе матрицы данных размером [M, N], где N — количество серий значений (далее серий), М — количество точек, замерами в которых получены значения серий.

Для количественной ориентации в диаграмме используются координатные оси. Каждому значению, отмеченному на оси, соответствует поясняющее имя (метка). В зависимости от типа координатной оси, метка может быть рассчи­танной, или определяться при заполнении данными.

С точки зрения настройки, диаграмма состоит из четырех областей:

• область диаграммы — совокупность всех областей образующих диаграмму;

• область построения диаграммы — содержит координатное пространство и изображенную на нем фигуру;

• заголовок диаграммы;

• легенда — вспомогательная область, содержащая список меток, соответст­вующих сериям.

Настройка размеров и положения областей диаграммы производится визуально. Подробнее о порядке визуальной настройки формата диаграммы следует читать в книге «Руководство по конфигурированию и администрированию».

Атрибуты диаграммы

Заголовок

Заголовок диаграммы.

Синтаксис:

Заголовок

Англоязычный синоним:

TitleText

Описание:

Атрибут Заголовок содержит текст заголовка диаграммы. По умолчанию имеет значение «Диаграмма».

Пример:

Диаграмма.Заголовок = "Пример использования диаграммы";

Методы диаграммы

КоличествоСерий

Явно устанавливает количество серий диаграммы.

Синтаксис:

КоличествоСерий(<Количество>)

Англоязычный синоним:

SeriesCount

Параметры:

<Количество>

Числовое выражение, которое задает количество серий диаграммы.

Возвращаемое значение:

Текущее значение количества серий (до исполнения метода).

Описание:

Метод КоличествоСерий явно устанавливает количество серий диаграм­мы. Количество серий может быть изменено и в режиме визуальной настройки. Альтернативой использования этого метода является неявное изменение коли­чества серий: в случае если в метод, одним из параметров, использующий но­мер серии, передается значение превышающее количество серий, количество серий будет неявно увеличено.

Пример:

Диагр.КоличествоСерий(3); // установим количество серий 3

КоличествоТочек

Явно устанавливает количество точек диаграммы.

Синтаксис:

КоличествоТочек(<Количество>)

Англоязычный синоним:

PointsCount

Параметры:

<Количество>

Числовое выражение, которое задает количество точек диаграммы.

Возвращаемое значение:

Текущее значение количества точек (до исполнения метода).

Описание:

Метод КоличествоТочек явно устанавливает количество точек диаграммы. Количество точек может быть изменено и в режиме визуальной настройки. Альтернативой использования этого метода является неявное изменение коли­чества точек: в случае если в метод, одним из параметров, использующий номер точек, передается значение превышающее количество точек, количество точек будет неявно увеличено.

Пример:

Диагр.КоличествоТочек(4); // установим количество точек 4

УстановитьИмяСерии

Устанавливает имя серии.

Синтаксис:

УстановитьИмяСерии(<НомерСерии>, <Имя>)

Англоязычный синоним:

SetSeriesLabel

Параметры:

<НомерСерии>	Числовое выражение, которое задает номер серии, для которой устанавливается имя.
<Имя>	Строка, используемая для обозначения серии в ле­генде и подписях к координатным осям.

Описание:

Метод УстановитьИмяСерии явно устанавливает имя для заданного номе­ра серии.

Пример:

Диаграмма.УстановитьИмяСерии(СчетчикСерий, Запрос.Товар.Наименование);