Gantt¶

@XmlAccessorType @XmlType

public class Gantt extends Tree implements Serializable ¶

Added in version AS: 1.20.0-ms25 Реализовано событие OnFocusedItemChanged

Группа свойств диаграммы Гантта.

Фрейм содержит дерево, к которому подключен компонент “диаграмма Гантта”. Рабочая область диаграммы отображает в графическом виде данные, содержащиеся в дереве. Данные отображаются в виде цветных элементов, на строках, расположенных напротив соответствующих узлов дерева. Диаграмма строится на основе данных загруженных деревом, поэтому оно должно содержать минимум 2 атрибута: первый с датой начала процесса или действия, второй с датой окончания процесса или действия. По умолчанию имена этих атрибутов dDateBegin и dDateEnd соответственно. Так же, возможно управлять цветом и стилем элементов диаграммы. Для этого дерево должно содержать атрибуты со значениями цветов (RGB) и системными именами стилей элементов (эти атрибуты обязательными не являются). По умолчанию имена атрибутов цвета и стиля: nItemColor и sItemStyle соответственно. Вы можете изменить имена используемых атрибутов в свойствах фрейма, в разделе “Параметры графика Гантта”.

Общие правила построения диаграммы Гантта:

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

Возможные значения стилей элементов:
- gisPipe - Прямоугольный элемент с заливкой указанного цвета с небольшим градиентом.
- gisLine - Линия. gisLineWEnd - Линия, ограниченная с обоих концов вертикальными линиями.
- gisSpan - Диапазон (линия со стрелками на концих, направленными вниз)
- gisSquare - Прямоугольник с чёрными границами и заливкой указанного цвета

События:

OnFocusedItemChanged - срабатывает на получение выделения элементом

Fields¶

captionCrop¶

protected Boolean captionCrop¶: Added in version AS: 1.21.0_rc_3

Флаг, указывающий, что текст элемента не должен выходить за границы элемента. Флаг имеет смысл только при расположении текста на элементе: True — обрезать текст; False — не обрезать текст (в этом случае текст может быть длиннее самого элемента). Флаг применяется ко всем GanttItem’ам. Флаг может быть переопределен для отдельных GanttItem’ов

captionWordWrap¶

protected Boolean captionWordWrap¶: Added in version 1.19.0.

Флаг управляющий переносом строк в caption GanttItem’a. Флаг применяется ко всем GanttItem’ам. Флаг может быть переопределен для отдельных GanttItem’ов

copyNodesToParent¶

protected Boolean copyNodesToParent¶: Отображать элементы подчинённых узлов. Если узел не имеет собственных элементов, но обладает подчинёнными узлами, по умолчанию, элементы из подчинённых узлов копируются в текущий узел. Данное свойство позволяет изменить это поведение. Если флаг снят, элементы подчинённых узлов не будут копироваться в текущий.

ct_captionCrop¶

public static final String ct_captionCrop¶

ct_currentDateUpdateRate¶

public static final String ct_currentDateUpdateRate¶

currentDateColor¶

protected String currentDateColor¶

currentDatePenStyle¶

protected String currentDatePenStyle¶

currentDateUpdateRate¶

protected Long currentDateUpdateRate¶: Added in version 1.21.0-rc4.

Период обновления текущей даты и времени на диаграмме. В миллисекундах. По умолчанию равен 60000 (минуте). Возможные форматы значения: 1234, 1K, 1M, 1G, 1T (Число от 0 до Long.MAX_VALUE). Заданное значение меньше 1000 (секунды) будет увеличено до 1000.

gridLinesVisible¶

protected Boolean gridLinesVisible¶: Видимость сетки. Флаг управляет видимостью чередующихся горизонтальных линий, соответсвующих строкам, на рабочей области Гантта.

highlightHolidays¶

protected Boolean highlightHolidays¶: Выделять праздничные дни. Флаг управляет выделением цветом празничных дней.

highlightRestDays¶

protected Boolean highlightRestDays¶: Выделять выходные дни. Флаг управляет выделением цветом выходных дней.

holidaysColor¶

protected String holidaysColor¶

Цвет выделения праздничных дней. Задается 32-битным значением в одном из двух форматов RGB:

Hex(Шестнадцатеричный): $BBGGRR, где BB—синий, GG—зеленый, RR—красный компоненты (например, $AE5300)
Dec(Десятичный): целое число от 0 до 16777215. Пример: 11424512 (эквивалент $AE5300)

Значение по умолчанию: $9878F7 (розовый)

itemBeginDateAttr¶

protected String itemBeginDateAttr¶: Атрибут - “Даты начала”. Свойство указывает на атрибут, содержащий дату начала процесса, отображаемого в виде элемента диаграммы.

itemCaptionAttr¶

protected String itemCaptionAttr¶: Атрибут текста элемента

itemColorAttr¶

protected String itemColorAttr¶: Атрибут цвета элемента

itemEndDateAttr¶

protected String itemEndDateAttr¶: Атрибут даты окончания. Свойство указывает на атрибут, содержащий дату окончания процесса, отображаемого в виде элемента диаграммы.

itemHintAttr¶

protected String itemHintAttr¶: Атрибут с текстом подсказки элемента

itemIdAttr¶

protected String itemIdAttr¶: Атрибут идентификатора элемента

itemParamsAttr¶

protected String itemParamsAttr¶

Атрибут с дополнительными параметрами элемента. Для случая если элементы хранятся в текущей выборке но в разных атрибутах.

Свойство содержит системное имя атрибута, в котором хранятся дополнительные параметры элемента диаграммы Гантта. Дополнительными параметрами являются, выравнивания теста, шрифт текста элемента и др. Параметры элемента указываются в виде строки с разделителями. Строка должна иметь следующий формат: {Параметр}={значение};{Параметр}={значение} Значения параметров элемента разделены точкой с запятой “ ; “

itemStyleAttr¶

protected String itemStyleAttr¶

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

gisPipe – Прямоугольный элемент с заливкой указанного цвета с небольшим градиентом.
gisLine – Линия.
gisLineWEnd – Линия, ограниченная с обоих концов вертикальными линиями.
gisSpan – Диапазон (линия со стрелками на концих, направленными вниз).
gisSquare – Прямоугольник с чёрными границами и заливкой указанного цвета.
gisCircle – Круг, положение которого на диаграмме зависит только от StartDate.
gisRectangle – Прямоугольник, положение которого на диаграмме зависит только от StartDate.
gisDiamond – Ромб, положение которого на диаграмме зависит только от StartDate.
gisBackground – Заштрихованный прямоугольник без границ с заливкой указанного цвета, который занимает всю высоту строки. Положение зависит от StartDate и StopDate; отображается позади элементов других стилей; не может быть выделен или кликнут.

itemsDataAttr¶

protected String itemsDataAttr¶

Атрибут с параметрами элементов.

Применяется только в одноколоночном режиме (mode == GanttModes.SingleColumn).

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

Параметры элемента указываются в виде строки с разделителями. Строка должна иметь следующий формат: {Параметр}={значение};{Параметр}={значение} Имя и значение разделяется символом =, пары имя-значение разделяются символом ;.

linesVisible¶

protected Boolean linesVisible¶: Разлиновка. Флаг управляет видимостью вертикальных линий, соответсвующих границам временных периодов.

linksAttr¶

protected String linksAttr¶: Атрибут с параметрами связей между элементами. Свойство указывает на атрибут, содержащий параметры связей между элементами диаграммы в виде сторки. Связью называется стрелка, соединяющая 2 элемента диаграммы Гантта. Строка должна иметь следующий формат: SourceID;DestID|SourceID;DestID где: SourceID - идентификатор элемента, из которого выходит стрелка DestID - идентификатор элемента, к которому приходит стрелка Значения параметров разделены точкой с запятой “ ; ” Элементы разделены вертикальной чертой “ | ” Пример: 1212322001;1212324001|1212323001;1212325001 Значение атрибута должно содержать связи, которые начинаются от элементов, находящихся в текущем узле. В каком узле находится элемент, у которого связь оканчивается, значения не имеет.

mode¶

protected GanttModes mode¶

Режим работы графика Гантта.

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

Одноколоночный режим. Одна строка графика гантта может содержать несколько элементов. Все параметры элементов строки хранятся в одном атрибуте, в формате строки с разделителями. Aтрибут указывается в свойстве “itemsDataAttr”

progressAttr¶

protected String progressAttr¶: Атрибут со значением прогресса. Свойство содержит системное имя атрибута, в котором хранится значение “прогресса” (степени выполнения задачи или процесса). “Прогресс” измеряется в процентах от 0 до 100. На графике “прогресс” отображается в виде полосы на элементе, обозначающем соответствующую задачу или процесс. Если прогресс не указан, имеет отрицательную величину или имеет значение больше 100, значок прогресса не отображается. (Свойство не обязательное)

restDays¶

protected String restDays¶: Выходные дни. Свойство содержит перечисление (1..7) выходных дней недели через точку запятой. Например: “6;7;” – Выходные суббота и воскресенье.

restDaysColor¶

protected String restDaysColor¶

Цвет выделения выходных дней. Задается 32-битным значением в одном из двух форматов RGB:

Hex(Шестнадцатеричном): $BBGGRR, где BB—синий, GG—зеленый, RR—красный компоненты (например, $AE5300)
Dec(Десятичном): целое число от 0 до 16777215 (например, 11422208)

Значение по умолчанию: $9878F7 (розовый)

showCurrentDate¶

protected Boolean showCurrentDate¶: Отображать текущую дату и время на диаграмме.

Constructors¶

Gantt¶

public Gantt()¶

Methods¶

getCaptionCrop¶

public Boolean getCaptionCrop()¶

getCaptionWordWrap¶

public Boolean getCaptionWordWrap()¶

getCopyNodesToParent¶

public Boolean getCopyNodesToParent()¶

getCurrentDateColor¶

public String getCurrentDateColor()¶

getCurrentDatePenStyle¶

public String getCurrentDatePenStyle()¶

getCurrentDateUpdateRate¶

public Long getCurrentDateUpdateRate()¶

Added in version 1.21.0-rc4.

Получить период обновления текущей даты и времени на диаграмме.

Returns:: Long - период в миллисекундах.

getGridLinesVisible¶

public Boolean getGridLinesVisible()¶

getHighlightHolidays¶

public Boolean getHighlightHolidays()¶

getHighlightRestDays¶

public Boolean getHighlightRestDays()¶

getHolidaysColor¶

public String getHolidaysColor()¶

getItemBeginDateAttr¶

public String getItemBeginDateAttr()¶

getItemCaptionAttr¶

public String getItemCaptionAttr()¶

getItemColorAttr¶

public String getItemColorAttr()¶

getItemEndDateAttr¶

public String getItemEndDateAttr()¶

getItemHintAttr¶

public String getItemHintAttr()¶

getItemIdAttr¶

public String getItemIdAttr()¶

getItemParamsAttr¶

public String getItemParamsAttr()¶

getItemStyleAttr¶

public String getItemStyleAttr()¶

getItemsDataAttr¶

public String getItemsDataAttr()¶

getLinesVisible¶

public Boolean getLinesVisible()¶

getLinksAttr¶

public String getLinksAttr()¶

getMode¶

public GanttModes getMode()¶

getProgressAttr¶

public String getProgressAttr()¶

getRestDays¶

public String getRestDays()¶

getRestDaysColor¶

public String getRestDaysColor()¶

getShowCurrentDate¶

public Boolean getShowCurrentDate()¶

setCaptionCrop¶

public void setCaptionCrop(Boolean captionCrop)¶

setCaptionWordWrap¶

public void setCaptionWordWrap(Boolean captionWordWrap)¶

setCopyNodesToParent¶

public void setCopyNodesToParent(Boolean copyNodesToParent)¶

setCurrentDateColor¶

public void setCurrentDateColor(String currentDateColor)¶

setCurrentDatePenStyle¶

public void setCurrentDatePenStyle(String currentDatePenStyle)¶

setCurrentDateUpdateRate¶

public void setCurrentDateUpdateRate(Long currentDateUpdateRate)¶

Added in version 1.21.0-rc4.

Задать период обновления текущей даты и времени на диаграмме.

Parameters:

currentDateUpdateRate –
- Long - период в миллисекундах.

setGridLinesVisible¶

public void setGridLinesVisible(Boolean gridLinesVisible)¶

setItemBeginDateAttr¶

public void setItemBeginDateAttr(String itemBeginDateAttr)¶

setItemCaptionAttr¶

public void setItemCaptionAttr(String itemCaptionAttr)¶

setItemColorAttr¶

public void setItemColorAttr(String itemColorAttr)¶

setItemEndDateAttr¶

public void setItemEndDateAttr(String itemEndDateAttr)¶

setItemHintAttr¶

public void setItemHintAttr(String itemHintAttr)¶

setItemIdAttr¶

public void setItemIdAttr(String itemIdAttr)¶

setItemParamsAttr¶

public void setItemParamsAttr(String itemParamsAttr)¶

setItemStyleAttr¶

public void setItemStyleAttr(String itemStyleAttr)¶

setItemsDataAttr¶

public void setItemsDataAttr(String itemsDataAttr)¶

setLinesVisible¶

public void setLinesVisible(Boolean linesVisible)¶

setLinksAttr¶

public void setLinksAttr(String linksAttr)¶

setMode¶

public void setMode(GanttModes mode)¶

setProgressAttr¶

public void setProgressAttr(String progressAttr)¶

setShowCurrentDate¶

public void setShowCurrentDate(Boolean showCurrentDate)¶