Круговая диаграмма

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

Круговая диаграмма

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

1. Перетащите элемент Круговая диаграмма  из палитры Статистика в то место графического редактора, где Вы хотите нарисовать диаграмму.

Основные свойства

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

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

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

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

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

Заголовок – Заголовок этого элемента данных, который будет отображаться в легенде диаграммы. 

Значение – Выражение, вычисляющее значение данного элемента данных. Это выражение будет динамически вычисляться во время выполнения модели, и его результат будет отображаться на диаграмме.

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

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

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

Обновлять данные автоматически после каждого "прогона"/итерации - [Видно, если диаграмма находится на диаграмме эксперимента] - Если опция выбрана, то диаграмма будет обновлять отображаемые на ней данные после каждого "прогона"/итерации модели.

Дополнительные свойства

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

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

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

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

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

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

Разрешить программное управление – Если опция выбрана, то диаграмма будет представлена в модели как Java объект, и она будет доступна из кода по имени. С помощью программного интерфейса Вы сможете изменять визуальные свойства диаграммы и тем самым управлять ее внешним видом во время выполнения модели.

Динамические свойства

Имя	Тип	Описание
Количество	int	Количество экземпляров данной диаграммы. Если Вы оставите это поле пустым, то будет создана только одна такая диаграмма.
Видимость	boolean	Видимость диаграммы.  Диаграмма будет видна, если заданное здесь выражение будет истинно (true), в противном случае диаграмма отображаться не будет.
X	double	X-координата верхнего левого угла диаграммы.
Y	double	Y-координата верхнего левого угла диаграммы.
Ширина	int	Ширина диаграммы (в пикселах).
Высота	int	Высота диаграммы (в пикселах).
Действие при изменении выделения	-	Код, который будет выполняться, когда пользователь выделит на диаграмме какой-то один (или несколько) элемент(ов) данных. Код будет вызываться как в том случае, если пользователь выделит элементы, щелкнув мышью по их заголовкам в легенде, так и в том случае, если он выделит  их программно путем вызова метода selectItem().  Вы можете использовать в этом коде две переменные: int[] selectedIndices - номера выделенных в текущий момент элементов данных. boolean programmatically - определяет, были ли элементы выделены программно (true) или нет (false).
Действие при удалении элемента	-	Код, который будет выполняться, когда пользователь удалит с диаграммы какой-то один (или несколько) элемент(ов) данных. Код будет вызываться как в том случае, если пользователь удалит элементы из контекстного меню легенды диаграммы, так и в том случае, если он удалит  их программно путем вызова методов remove() и removeAll(). Вы можете использовать в этом коде две переменные: int removedIndex - номер только что удаленного элемента данных. boolean programmatically - определяет, был ли элемент удален программно (true) или нет (false).

Внешний вид

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

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

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

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

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

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

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

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

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

1. Выделите диаграмму в графическом редакторе или в панели Проекты.
   
2. Перейдите на страницу Основные панели Свойства.
3. Щелкните мышью по кнопке Добавить элемент данных. При этом над кнопкой появится новая секция свойств, задающая настройки нового элемента данных, который будет отображаться на данной диаграмме.
4. В этой секции Вам нужно будет указать заголовок для этого элемента в поле Заголовок. Введенный здесь текст будет отображаться в легенде диаграммы.
5. Введите выражение, вычисляющее значение данного элемента данных, в поле Значение. Это выражение будет динамически вычисляться во время выполнения модели, и его результат будет отображаться на диаграмме.
6. Цвет, которым будет отображаться данный элемент данных на диаграмме. Щелкните мышью внутри элемента управления Цвет и выберите нужный цвет из списка наиболее часто используемых цветов или же выберите любой другой цвет с помощью диалога Цвета.

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

См. также

 Справочник классов: Класс PieChart