Gantt¶

class View.Representation.Layout.Frame.Gantt¶

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

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

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

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

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

События:

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

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

See also

:ref:Gantt<gantt_frame>

Атрибуты:

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

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

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

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

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

attr holidaysColor → String¶

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

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

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

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

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

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

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

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

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

attr itemParamsAttr → String¶

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

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

attr itemStyleAttr → String¶

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

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

attr itemsDataAttr → String¶

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

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

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

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

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

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

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

attr restDaysColor → String¶

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

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

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

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

attr currentDatePenStyle → String¶

attr currentDateColor → String¶

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

Added in version 1.21.0-rc4.

attr mode → View.Representation.Layout.Frame.Gantt.GanttModes¶

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

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

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

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

Added in version 1.19.0.

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

Added in version AS: 1.21.0_rc_3

attr dragDrop.rows.autoDropTo → Boolean¶: Автоматическое перемещение записи при перетаскивании. Компонент древовидный список обладает функциональность позволяющей без написания собственной логики выполнять перемещение записи между узлами. Если свойство установлено в “включено”, то будем выполняться автоматическое перемещение записи, если “выключено” - тогда в паскаль операции onDragDrop необходим пользовательский код, который выполнит перецепление родительской записи. По умолчанию при автоматическом перемещение после завершения перетаскивания записи, запись становиться дочерней по отношений к той над которой было закончено перетаскивание. Для управления поведением(переместить в качестве потомка, или на тот же уровень) при бросаниие записи реализивано свойство Controller.DropAsChild.

attr hasChildrenAttr → String¶: Атрибут с флагом наличия потомком

attr idAttr → String¶: Атрибут с идентификатором

attr idParentAttr → String¶: Атрибут с идентификатором предка

attr imageIndexAttr → String¶

Атрибут с порядковым номером изображения из коллекции Tree.imageListName.

Выбранное изображение отображается в начале записи (строки).

Подробное описание свойства указано в спецификации сервиса коллекций изображений.

attr idRoot → String¶: Идентификатор корня дерева. Идентификатор записи, с которой начнется построение дерева.

attr imageListName → String¶

Имя коллекции изображений, используемой деревом для отображения изображений в начале записей.

Конкретное изображение, отображаемое в начале записи, выбирается по значению атрибута, который указан в Tree.imageIndexAttr.

Подробное описание свойства указано в спецификации сервиса коллекций изображений.

attr expandAllNodes → Boolean¶: Раскрыть все загруженные узлы. Раскрвает все загруженые узлы после открытия или обновления дерева.

attr expandNodeLevel → Integer¶: Открывать узлы. Уровень узлов дерева, которые будут открыты при открытии выборки.

attr isHeaderVisible → Boolean¶: Заголовок

attr dragDrop.rows.dragMode → View.Representation.Layout.Frame.Grid.DragAndDropRowModes¶: Режим начала перетаскивания. Режим перетаскивания определяет как будет запускаться процесс перетаскивания: автоматически (dmAutomatic) - перетаскивание начинается после начала перемещения указателя мыши в “нажатом” состоянии. в ручном режиме (dmManual) - при нажатии на кнопку манипулятора типа “мышь” вызывается операция-триггер OnCanStartDrag, в которой програмист самомстоянеть включает режим перетаскивания.

attr dragDrop.rows.isDragEnabled → Boolean¶: Разрешает перетаскивать строки с данного фрейма.

attr dragDrop.rows.isDropEnabled → Boolean¶: Разрешает перетаскивать строки на фрейм фрейма

attr cellHint → String¶: Текст всплывающий подсказки ячееки

attr headerRowCount → Integer¶: Высота заголовка

attr headerStyle → String¶: Стиль заголовков

attr invertCurrentRow → Boolean¶: Инвертировать цвет текущей строки

attr isMultilineRow → Boolean¶: Динамическая высота записи

attr linesInRow → Integer¶: Высота записи

attr lockMovingColumns → Boolean¶: Запретить перетаскивание колонок

attr isMultiSelectEnabled → Boolean¶: Мультиселект (выбор нескольких записей)

attr isAsyncMode → Boolean¶: Возможность редактирования грида без ожидания выполнения операций на сервере

attr commentAttribute → String¶: Атрибут, информирующий о наличии комментариев

attr commentTextAttribute → String¶: Атрибут, содержащий текст комментариев

attr gridComponentLib → View.Representation.Layout.Frame.Grid.GridComponentLibs¶

Управляет типом UI-компонентов, которые будут использоваться для отображения списочных контролов (грид, дерево)

Значение по умолчанию: GridComponentLibEnum.Gxt

С помощью отладочной переменной “Force ag-grid (override gridComponentLib prop)” можно включить отображение ag-grid во время выполнения для любого грида.

Added in version 1.19: ms 27

Added in version 1.20.0: Добавлена отладочная переменная