Столбиковая диаграмма

Свойства
Функции

Столбиковая диаграмма отображает несколько элементов данных в виде столбцов, «растущих» в заданном направлении от базовой линии. Размеры столбцов пропорциональны значениям соответствующих элементов данных.

Если значения будут отрицательными, то столбцы будут «расти» в противоположную сторону.

Чтобы добавить столбиковую диаграмму

Перетащите элемент Столбиковая диаграмма из палитры Статистика в то место графического редактора, где вы хотите нарисовать диаграмму.
Перейдите в секцию Данные панели Свойства.
Укажите заголовок для элемента данных в поле Заголовок. Введенный здесь текст будет отображаться в легенде диаграммы.
Введите выражение, вычисляющее значение данного элемента данных, в поле Значение. Это выражение будет динамически вычисляться во время выполнения модели, и его результат будет отображаться на диаграмме.
Чтобы задать цвет, которым будет отображаться данный элемент данных на диаграмме, щелкните мышью внутри элемента управления Цвет и выберите нужный цвет из списка наиболее часто используемых цветов или же выберите любой другой цвет с помощью диалога Цвета.
Задайте направление роста столбцов и их суммарную ширину с помощью свойств Направление и Относительная ширина, которые находятся в секции свойств Внешний вид. Суммарная ширина столбцов указывается относительно ширины всего элемента столбиковой диаграммы (100% — максимальная ширина, 50% — половина, и так далее.)

Чтобы добавить элемент данных на диаграмму

Новая столбиковая диаграмма уже содержит элемент данных. Если вы хотите добавить еще один элемент данных, выполните следующие шаги:

Выделите диаграмму в графическом редакторе или в панели Проекты.
Перейдите в секцию Данные панели Свойства.
Щелкните мышью по кнопке . При этом над кнопкой появится новая секция свойств, задающая настройки нового элемента данных, который будет отображаться на данной диаграмме.

Чтобы удалить элемент данных с диаграммы

Выделите диаграмму в графическом редакторе или в панели Проекты.
Перейдите в секцию Данные панели Свойства.
Выделите элемент данных, который вы хотите удалить с данной диаграммы, и щелкните мышью по кнопке внизу секции Данные.

Свойства

Основные

Имя — Имя диаграммы. По этому имени диаграмма будет доступна из кода.

Исключить — Если опция выбрана, то диаграмма будет исключена из модели.

Отображается на верхнем агенте — Если опция выбрана, то диаграмма будет видна на презентации типа агента, в который будет вложен данный агент.

Масштаб — Здесь вы можете выбрать режим масштабирования диаграммы. Выберите режим автомасштабирования (Авто), масштабирование, при котором столбцы будут занимать всю область диаграммы (100%), либо же Фиксированный режим, при котором шкала диаграммы будет иметь четко заданные минимум и максимум (задающиеся в поле От и До).

Обновлять данные автоматически — Если опция выбрана, то диаграмма будет производить обновление значений отображаемых на ней элементов данных с периодичностью, указанной в поле Период. Так же здесь вы можете выбрать, хотите ли вы Использовать модельное время, чтобы задать Время первого обновления, или вы хотите Использовать календарные даты, чтобы задать Дату обновления.

Не обновлять данные автоматически — Если опция выбрана, то диаграмма не будет самостоятельно производить обновление значений отображаемых на ней элементов данных.

Данные

— С помощью этой кнопки вы можете добавить новый элемент данных на диаграмму. Щелкнув по ней, вы откроете новую секцию свойств, в которой вы должны будете задать свойства нового элемента данных, значение которого вы хотите отображать на диаграмме:

Заголовок — Заголовок этого элемента данных, который будет отображаться в легенде диаграммы.
Значение — Выражение, вычисляющее значение данного элемента данных. Это выражение будет динамически вычисляться во время выполнения модели, и его результат будет отображаться на диаграмме.
Цвет — Цвет, которым будет отображаться данный элемент данных на диаграмме. Щелкните мышью внутри элемента управления и выберите нужный цвет из списка наиболее часто используемых цветов или же выберите любой другой цвет с помощью диалога Цвета. Чтобы удалить элемент данных с диаграммы, щелкните мышью по кнопке внизу этой секции свойств. Используйте кнопки и , чтобы изменять порядок расположения элементов данных.

Внешний вид

Направление столбцов — Группа кнопок, задающая направление роста столбцов диаграммы.

Относительная ширина столбцов — С помощью данного бегунка вы можете задавать суммарную ширину оснований столбцов (в процентах, относительно соответствующей размерности диаграммы, 100% — максимум, 50% - половина и т.д.).

Положение подписей у осей — С помощью данного выпадающего списка вы можете задать расположение меток, отображаемых для оси Y, относительно области диаграммы (Слева или Справа). Если вы не хотите, чтобы у диаграммы отображались метки, выберите из списка Нет.

Цвет фона — Фоновый цвет области диаграммы. Щелкните мышью внутри элемента управления и выберите нужный цвет из списка наиболее часто используемых цветов или же выберите любой другой цвет с помощью диалога Цвета.

Цвет границы — Цвет, которым будет отображаться граница области диаграммы. Щелкните мышью внутри элемента управления и выберите нужный цвет из списка наиболее часто используемых цветов или же выберите любой другой цвет с помощью диалога Цвета.

Цвет меток — Цвет, которым будут отображаться метки по оси Y. Щелкните мышью внутри элемента управления и выберите нужный цвет из списка наиболее часто используемых цветов или же выберите любой другой цвет с помощью диалога Цвета. Если вы не хотите, чтобы метки были видны, выберите Нет цвета.

Цвет сетки — Цвет, которым будет отображаться сетка диаграммы. Щелкните мышью внутри элемента управления и выберите нужный цвет из списка наиболее часто используемых цветов или же выберите любой другой цвет с помощью диалога Цвета. Если вы не хотите, чтобы сетка была видна, выберите Нет заливки.

Местоположение и размер

Уровень — Уровень, на котором находится эта диаграмма.

X — X-координата верхнего левого угла диаграммы.

Y — Y-координата верхнего левого угла диаграммы.

Ширина — Ширина диаграммы (в пикселях).

Высота — Высота диаграммы (в пикселях).

Легенда

Легенда — Если опция выбрана, то у данной диаграммы будет отображаться легенда. Вы можете управлять местоположением легенды относительно области диаграммы с помощью группы кнопок Расположение. Размер области, выделенной под легенду, задается с помощью элемента управления Ширина (или Высота, в зависимости от того, какое задано Расположение легенды). Также вы можете изменить Цвет текста легенды.

Область диаграммы

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

Смещение по оси X — Смещение области диаграммы по оси X относительно левой границы всей области, выделенной в графическом редакторе под диаграмму.

Смещение по оси Y — Смещение области диаграммы по оси Y относительно верхней границы всей области, выделенной в графическом редакторе под диаграмму.

Ширина — Ширина области диаграммы (в пикселях).

Высота — Высота области диаграммы (в пикселях).

Специфические

Видимость — Видимость диаграммы. Диаграмма будет видна, если заданное здесь выражение будет истинно (true), в противном случае диаграмма отображаться не будет.

Количество — Количество экземпляров данной диаграммы. Если вы оставите это поле пустым, то будет создана только одна такая диаграмма.

Действие при изменении выделения — Код, который будет выполняться, когда пользователь выделит на диаграмме какой-то один (или несколько) элемент(ов) данных. Код будет вызываться как в том случае, если пользователь выделит элементы, щелкнув мышью по их заголовкам в легенде, так и в том случае, если он выделит их программно путем вызова метода selectItem(). Вы можете использовать в этом коде две переменные:

int[] selectedIndices — номера выделенных в текущий момент элементов данных
boolean programmatically — определяет, были ли элементы выделены программно (true) или нет (false)

Отображать имя — Если опция выбрана, то имя фигуры будет отображаться в графическом редакторе.

Функции

Данные диаграммы

Функция	Описание
void addDataItem(DataItem di)	Добавляет на диаграмму элемент данных с заданным по умолчанию заголовком и цветом. di — элемент данных для добавления
void addDataItem(DataItem di, String title, Color color)	Добавляет на диаграмму элемент данных. di — элемент данных для добавления title — заголовок элемента данных color — цвет, которым будет отображаться столбик данного элемента
int getCount()	Возвращает количество элементов данных, отображаемых этой диаграммой.
ChartItem get(int i)	Возвращает элемент диаграммы (DataItem) с заданным индексом. i — индекс элемента данных
String getTitle(int i)	Возвращает заголовок элемента данных с заданным индексом i.
Color getColor(int i)	Возвращает цвет элемента диаграммы (DataItem, DataSet) с заданным индексом. i — индекс элемента диаграммы
void setColor(int i, Color c)	Задает новый цвет элемента диаграммы (DataItem, DataSet) с заданным индексом. i — индекс элемента диаграммы c — новый цвет элемента диаграммы
void remove(int i)	Удаляет элемент с заданным индексом i с диаграммы.
int remove(ChartItem ci)	Удаляет заданный элемент (DataItem) с диаграммы. ci — набор данных для удаления
void removeAll()	Удаляет все элементы с диаграммы.

Шкала значений

Функция	Описание
void setFixedScale(double minimum, maximum)	Задает минимальное и максимальное значения по оси значений диаграммы. minimum — минимальное значение по оси maximum — максимальное значение по оси

Выделение элементов данных

Функция	Описание
void selectItem(int itemIndex, boolean selected)	Выделяет/снимает выделение (это зависит от значения параметра selected) с элемента диаграммы с заданным индексом. itemIndex — индекс элемента диаграммы selected — если true, то выделяет элемент, если false, то снимает выделение
void setSelectedItemIndices(int[] selectedIndices)	Выделяет элементы диаграммы с заданными индексами. Если ранее были выделены какие-то другие элементы, то это выделение будет снято. selectedIndices — массив индексов элементов диаграмм, которые будут выделены, может быть равен null — тогда выделение будет снято со всех элементов
int[] getSelectedItemIndices()	Возвращает количество элементов диаграммы, выделенных на диаграмме.

Ручное обновление данных диаграммы

Функция	Описание
void updateData()	Обновляет все элементы данных, отображаемые на этой диаграмме.

Местоположение

Функция	Описание
double getX()	Возвращает координату X диаграммы (а именно, ее левого верхнего угла).
double getY()	Возвращает координату Y диаграммы (а именно, ее левого верхнего угла).
void setX(double x)	Задает координату X диаграммы. x — новое значение координаты X
void setY(double y)	Задает координату Y диаграммы. y — новое значение координаты Y
void setPos(double x, double y)	Задает новые координаты диаграммы. x — новое значение координаты X y — новое значение координаты Y

Размер

Функция	Описание
double getWidth()	Возвращает ширину диаграммы.
double getHeight()	Возвращает высоту диаграммы.
void setWidth(double w)	Задает новую ширину диаграммы. w — новое значение ширины диаграммы
void setHeight(double h)	Задает новую высоту диаграммы. h — новое значение высоты диаграммы

Видимость

Функция	Описание
boolean isVisible()	Проверяет видимость диаграммы: если диаграмма отображается, то функция возвращает true, если не отображается — то false.
void setVisible(boolean v)	Устанавливает видимость диаграммы. v — видимость: если true — диаграмма будет видимой, если false — невидимой.

Копирование данных диаграммы в буфер обмена

Функция	Описание
String copyToClipboard()	Копирует все данные диаграммы в системный буфер обмена. Функция возвращает текстовое представление всех данных диаграммы.

Как мы можем улучшить эту статью?