TreeGrid v6.3
Gantt objects
The Gantt chart can show various objects, possibly all together in one cell:
Gantt bars
Resizable, movable, support percentage completion, dependencies and resources.
Used as sources for Gantt chart calculations (e.g. correcting dependencies or calculate critical path)
Main bar or Milestone One solid bar. Milestone is zero length main bar.
Used usually for (continuous) planned task
Real Flow One or more bars, as one non continuous flow, all in one color, adjacent bars can be merged. Supports also milestones.
Can be used as non continuous planned task to replace main bar, with percentage completion.
Or can be used as actual running of the planned task, without percentage completion.
Run The most complex bar type. One or more independent bars with different color, class, caption, tooltip and unique id. Supports also milestones.
It supports also many options for moving and resizing the boxes.
Can be used as complex planned task.
Or it can be used for any other interactive bar chart, not only for the Gantt.
Gantt icons
Not resizable, but movable objects
Flag One or more icons in the cell, on specified dates, with defined tooltip text. Supports custom icons and their changing.
Usually used to attach some information and icon to selected date(s).
Does not affect any Gantt calculations, except width of the Gantt column.
Point One or more different movable bullets. With different icons, tooltip and edit permissions.
Used usually in math charts to display various points on specified positions.
Does not affect any Gantt calculations, except width of the Gantt column.
Constraints Task constraints, specify limits where the Gantt bars (and optionally Gantt icons) can be moved or resized, used also for Gantt calculations.
Four different constraints: early start, late start, early end and late end.
Static objects
Not movable, not resizable, completely inactive
Mark One or more dates or date ranges to highlight them
Format Text displayed right to Gantt bar (to the first object in GanttObject)
Local calendar Gantt calendar - excluded dates (holidays). Marks these dates by different color.
It is used in all Gantt calculations and is also possible to restrict start / end Gantt objects in these ranges.
Global objects
Objects defined for the whole chart or between cells
Dependencies Lines between two tasks, the task can be defined by Gantt bar (to the first object in GanttObject).
The dependencies set relation between the tasks and are used in Gantt chart calculation (e.g. correcting dependencies or calculate critical path)
The dependencies support edge type (ss,sf,fs,ff), lag and float.
The dependencies can be added, deleted and changed dynamically by mouse or keyboard.
Baseline Vertical line through all cells that specifies start of the whole project. It can be set, deleted or moved.
It is used in Gantt calculations, when correcting dependencies. It can work also as constraint.
Finish line Vertical line through all cells that specifies end of the whole project. It can be set, deleted or moved.
It is used in Gantt calculations, when calculating critical path. It can work also as constraint.
Header One or more Gantt header, can be placed above or below (or both) the Gantt chart in fixed rows.
Shows the individual dates in given format or numbers in math chart.
Background Background lines or rectangles vertically through all cells to mark and highlight some dates or date ranges in the chart
Global calendar Gantt calendar - excluded dates (holidays). Marks these dates by different color. The dates can be also hidden from the chart.
It is used in all Gantt calculations and is also possible to restrict start / end Gantt objects in these ranges.
Features
They are not visible objects, they are listed here just for completion
Resources Used for calculating task prices and other Gantt calculations.
It is possible also to display resources chart.
Critical path Gantt chart can calculate slack value for all tasks and mark tasks on or beyond critical path
Summary tasks Gantt chart can show various summary tasks, even movable, resizable and with dependencies
Zoom Zoom levels, possible from milliseconds to years. Smooth zoom available. Zooming by mouse dragging or clicking to date.
Menu Popup menu for the Gantt cell with items available for the clicked Gantt object.
API Gantt supports also various API methods and events to control end extend the Gantt chart from JavaScript.
The Gantt chart sources for objects are usually other columns where are stored the source data in cells. These cells can be also edited by user and Gantt chart is automatically updated.
<C> string GanttOrder [“Chart,Constraints,Run,Main,Flow,Mark,Dependency,Format,Flags,Points”] new 6.3;upd.6.4.
Comma separated list of all Gantt objects to render, case insensitive.
The order of rendering the Gantt objects. The objects rendered later will overlay the previous objects in the same place.
The not listed Gantt objects are never rendered.
It affects also accessibility (interactivity) of the objects, they are accessible in reversed order.
<C> string GanttObject [“Main”] new 6.4 .
The main Gantt object. Permitted objects are Main, Flow, Run. Case insensitive.
It is used for attaching and calculating dependencies, for assigning and calculating resources and the GanttFormat is displayed next to it.
It can contain more comma separated objects to use the first one existing in the cell, in this order.
It replaces deleted GanttDependencyObjects attribute.
<C><cell> string GanttFormat [Resources] new 6.4 .
Text displayed right to GanttFormatObject object.
By default it displays GanttResources value.
It can display any HTML text. It can also show values from other cells in row, set by *col* where col is the column name.
For example: GanttFormat="$<span style='color:#77F'>*P*</span> *R*" => shows value from P column (as price) and from R column (as resources).
<C><cell> string GanttFormatWidth new 7.0 .
Expected width in pixels of the text displayed by GanttFormat.
Set this value to speed up Gantt chart creating (especially for Paging), to use this value instead of measuring width of the GanttFormat.
This width is reserved when calculating the whole chart width to completely show the GanttFormat text.
<C> string GanttFormatObject [“Last”] new 6.4 .
Object next to the GanttFormat text will be displayed.
Last – the object from Main, Flow and Run positioned rightmost.
Object – GanttObject object
Main, Flow, Run – only for this object
If the selected object is not present in the cell, the text is not shown.
<C><cell> string GanttClass upd 6.0 .
The custom prefix for all CSS classes used in the Gantt chart.
The CSS classes with the custom prefix are added to the base class and are intended to change color or shape of the Gantt chart parts for particular rows.
There is one predefined black and white class GanttG for various purposes, e.g. grouped rows.
There are 17 predefined classes for bars in all 17 base colors: GanttAqua, GanttBlack, GanttBlue, GanttFuchsia, GanttGray, GanttGreen, GanttLime, GanttMaroon, GanttNavy, GanttOlive, GanttOrange, GanttPurple, GanttRed, GanttSilver, GanttTeal, GanttWhite, GanttYellow.
You can easily add or update the Gantt classes in the Grid.css file.
Remember, before the class is always added “Gx” as style prefix.
<C><cell> string[] GanttEdit [“all”] renamed 6.0 upd 6.4 .
Which parts can be edited / moved / changed / deleted / added by user. Comma separated list of flag names, case insensitive.
All All Gantt items are editable / movable
Main Main bars and milestones can be created, deleted and modified directly in Gantt chart
Flow Flow bars can be created, deleted and modified directly in Gantt chart
Run Run bars can be created, deleted and modified directly in Gantt chart
Flags Flags can be created, deleted, moved and modified directly in Gantt chart
Points (new 6.4) Points can be created, deleted, moved and modified directly in Gantt chart
Constraints (new 6.3) Constraints can be created, deleted and moved directly in Gantt chart
Dependency Dependency lines can be created and deleted directly in Gantt chart
DependencyTypes (new 6.3) Dependency type can be set by dragging to different bar edge (ss,sf,fs,ff)
DependencyLags (new 6.3) Dependency lag can be changed
Resources Resources can be assigned or entered directly in Gantt chart
To permit / restrict individual actions (e.g. only move, no resize or delete), attach appropriate actions to the cell(s). The default actions are attached in Defaults.xml:
OnDragGantt="ResizeGanttMain OR MoveGanttMain OR ResizeGanttFlow OR MoveGanttFlow OR ResizeGanttRun OR MoveGanttRun OR MoveGanttFlag OR MoveGanttPoint
OR MoveGanttConstraint OR MoveGanttBase OR MoveGanttFinish OR CreateGanttMain OR CreateGanttFlow OR CreateGanttRun OR DragGanttDependency"
To attach special set of actions to inividual Gantt cell, define <I ... xxxOnDragGantt=”....,1” ... />, where the xxx is name of your Gantt column. See “,1”, it ensures to not run the default actions from Defaults.xml.
For example <I ... GANTTOnDrag="MoveGanttMain OR MoveGanttFlow OR MoveGanttConstraint OR MoveGanttBase OR MoveGanttFinish OR DragGanttDependency"/>,
permits only moving specified objects, but restricts resizing, deleting and creating new objects.
Remember, you can use Default rows <D> to assign the same actions to more cells at once.
Use also OnCheckGantt event to control changes done by direct editing in source cells.
Use also GanttMenu to specify popup Gantt menu items for given cell.
<C> int GanttResizeDelete [1] new 6.1 .
If the Main, Flow and Run bars can be deleted by resizing them to zero width.
0 – no, 1 – yes, 2 – show confirm message
<C> int GanttCheck [4] new 6.3;upd 7.0.
Check if Gantt source cell change by a user edit is correct.
0 – do nothing
1 – restrict incorrect changes
2 – alert warning and restrict incorrect changes
3 – (new 7.0) automatically correct incorrect values
4 – (new 7.0) alert warning and correct incorrect values
It checks all dates to be within constraints, circular dependencies, percentage complete, negative duration, End>Start
<C> int GanttCheckTime [1000] new 7.0.
Time in milliseconds, how long will be displayed alert message for GanttCheck = ‘2’ and ‘4’.
If set to 0, the message will be shown forever with OK button.
If set to 1, standard browser alert will be shown.
If set to negative number, the message will be shown for the (positive) time, but with OK button.
<C><cell> int GanttHover [1] renamed 6.0 .
If the Gantt items under mouse cursor will be highlighted.
0 – never, 1 – only when it is editable / movable, 2 – always
<Actions> DeleteGanttAll ...F Not attached to any event .
Deletes all Gantt items from the actual or focused Gantt cell, including all dependencies.
Main bar
Planned task - one continuous bar, only one per row
To have discrete main bar use Flow with FlowComplete attribute instead.
Defined by GanttStart (start date) and GanttEnd (due date) or by GanttStart (start date) and GanttDuration (length).
The main bar can show % of completion set by GanttComplete.
<C><cell> string GanttStart Gantt source – column name or exact value .
Start date of the main bar, usually column name, but can be also date string (M/d/yyyy hh:mm:ss) or count of milliseconds.
If the start date is edited, the bar is moved.
<C><cell> string GanttEnd Gantt source – column name or exact value upd 6.3 .
Due date of the main bar, usually column name, but can be also date string (M/d/yyyy hh:mm:ss) or count of milliseconds
The end date can be last date or last unit, depending on GanttEndLast setting (new in 6.3).
When the GanttEnd date is empty (or the column value it points to), the milestone is displayed instead of main bar.
If the end date is edited, the bar is resized.
<C><cell> string GanttDuration Gantt source – column name or exact value upd 6.3 .
Duration between start date and end date in GanttDataUnits. Can be column name or float or string.
The length can contain also unit modifier set by GanttDataModifiers, for example one day is usually 1d or 8h or 0.2w (new in 6.3).
When the GanttDuration date is empty or 0 (or the column value it points to), the milestone is displayed instead of main bar.
<C><cell> string GanttComplete Gantt source – column name or exact value .
% of completion (0 – 100) of the task, can be column name or float.
<C><cell> string GanttText Gantt source – column name or exact value new 6.0 .
Text displayed as tooltip when mouse hovers the main bar or milestone.
<C><cell> string GanttMainTip new 6.4 .
Tip shown on mouse hover the main bar, but not milestone. It can contain HTML code.
By default it shows the value of GanttText.
It can also show values from other cells in row, set by *col* where col is the column name.
It can show also the specials: *Text* - show the GanttText, *Start* - start date of the main bar, *End* - end date of the main bar, *Duration* - length of the main bar.
Example: “*Start* - *End*<br>*Text*”
<C><cell> bool GanttIcons [0] renamed 6.0 .
If set to 1, on the ends of the main bar there are displayed icons to highlight the start and end dates. Usually used for group tasks.
It is just visual effect.
<C> bool GanttEditStartMove [1] new 6.5 .
If set to 0, editing start resizes the task (preserves end and changes duration)
If set to 1, editing start moves the task (changes end and preserves duration)
formula float ganttpercent (string ganttcol, string weightcol, int round) chg 6.3; upd 7.0.
Calculates summary percent of all child rows for its date ranges
ganttcol – gantt column, if it is null, uses the first Gantt column in grid
weightcol – column with exact weight factors for the tasks, if not set, the weight is computed from the task duration.
round – to how many decimal places will be the result rounded, by default it is not rounded at all (new 6.3)
Example: <I Calculated=’1’ CalcOrder=”Complete” CompleteFormula=”ganttpercent()”/>
Since 7.0 it can be used also to calculate percentage of summary of Flow tasks with GanttFlowComplete set. It calculates Flow only if child row does not define GanttStart.
formula int ganttstart (string ganttcol) new 7.0 .
Calculates summary (minimal) start of all child rows.
It calculates Main bars, Milestones and Flow. For Run use ganttrunminstart(). It calculates Flow only if child row does not define GanttStart.
ganttcol – gantt column, if it is null, uses the first Gantt column in grid
formula int ganttend (string ganttcol) new 7.0 .
Calculates summary (maximal) end of all child rows.
It calculates Main bars, Milestones and Flow. For Run use ganttrunmaxend(). It calculates Flow only if child row does not define GanttStart.
ganttcol – gantt column, if it is null, uses the first Gantt column in grid
formula float ganttduration (string ganttcol) chg 6.3 .
Calculated summary duration for child rows. Use when the gantt is set by start and duration instead of start and end date.
It returns duration from the actual row start date to the maximal end date in its child rows. Returns value in GanttDataUnits.
ganttcol – gantt column, if it is null, uses the first Gantt column in grid
Example: <I Calculated=’1’ CalcOrder=”Duration” DurationFormula=”ganttduration()”/>
formula int ganttpercentduration (string durationcol, string percentcol=’’, int round=0) deleted 6.3.
Replaced by ganttpercent.
<Actions> MoveGanttMain Attached to OnDragGantt, cannot be attached anywhere else new 7.0 .
Moves main bar by mouse dragging.
Fails, if mouse is not above main bar or main bar cannot be moved
<Actions> ResizeGanttMain Attached to OnDragGantt, cannot be attached anywhere else new 7.0 .
Moves main bar by mouse dragging
Fails, if mouse is not above main bar edge or main bar cannot be resized
<Actions> CreateGanttMain Attached to OnDragGantt, cannot be attached anywhere else new 7.0 .
Creates new main bar by mouse dragging.
Fails, if there is already one main bar in the cell or main bar cannot be created here
<Actions> DeleteGanttMain Attached to OnCtrlClickGantt event .
Deletes Main bar or Milestone if it is under mouse cursor.
It fails if there is neither Main bar nor Milestone under mouse cursor.
The main bar can be deleted also by resizing to zero width, if permitted by GanttResizeDelete.
<Actions> SetGanttPercent Attached to OnCtrlRightClickGantt event .
Changes % of completed to position under mouse cursor.
It fails if mouse is not above Main bar.
<Actions> EditGanttPercent Attached to OnShiftRightClickGantt event new 7.0 .
Lets a user to edit percentage completion of main bar or milestone under mouse cursor
<Actions> EditGanttText Attached to OnDblClickGantt event new 6.0 .
Lets a user to edit tooltip text of main bar or milestone under mouse cursor.
Deadline - one icon, only one per row, instead of main bar
Defined by GanttStart (exact date) with no GanttEnd / GanttDuration set.
(new 7.0) Or end milestone defined by GanttEnd with no GanttStart / GanttDuration set.
Difference between start and end milestone is in its display on and next to holidays, the end milestone is displayed before the holiday and start milestone after.
In fact it is the main bar with void length.
<C><cell> string GanttStart Gantt source – column name or exact value .
The date of the milestone, usually column name, but can be also date string (M/d/yyyy hh:mm:ss) or count of milliseconds.
If set, GanttEnd and GanttDuration must be empty or 0.
<C><cell> string GanttEnd Gantt source – column name or exact value new 7.0 .
The date of the end milestone, usually column name, but can be also date string (M/d/yyyy hh:mm:ss) or count of milliseconds.
If set, GanttStart and GanttDuration must be empty or 0.
<C><cell> string GanttDuration Gantt source – column name or exact value upd 6.3 .
Milestone must have set 0 or empty duration.
<C><cell> string GanttComplete Gantt source – column name or exact value new 7.0 .
% of completion (0 – 100) of the task, can be column name or float.
Milestone distinguishes only three states of complete: 100 (green), <100 (blue) and empty (black).
<C><cell> string GanttText Gantt source – column name or exact value new 6.0 .
Text displayed as tooltip when mouse hovers the milestone.
<C><cell> string GanttMilestoneTip new 6.4 .
Tip shown on mouse hover the milestone, similar to GanttMainTip.
<Actions> NewGanttMilestone Attached to OnDblClickGantt event .
Adds new milestone defined by GanttStart on mouse position, only when the cell has neither main bar nor milestone
It fails if there is already milestone or main bar in the cell.
<Actions> NewGanttEndMilestone Not attached to any event new 7.0 .
Adds new milestone defined by GanttEnd on mouse position, only when the cell has neither main bar nor milestone
It fails if there is already milestone or main bar in the cell.
<Actions> DeleteGanttMain Attached to OnCtrlClickGantt event .
Deletes Main bar or Milestone if it is under mouse cursor.
It fails if there is neither Main bar nor Milestone under mouse cursor.
<Actions> EditGanttText Attached to OnDblClickGantt event new 6.0 .
Lets a user to edit tooltip text of main bar or milestone under mouse cursor.
Real process of planned task - one or more discrete bars with the same meaning
Defined by GanttFlow (date ranges).
It is one task divided to one or more discrete parts. Adjacent parts are merged to one part except set GanttFlowJoin=’0’.
It can be discrete, can contain more date ranges. The first and last date in range are separated by tilde (~), ranges itself by semicolon (;).
<C><cell> string GanttFlow Gantt source – column name or exact value .
Real flow times, can be column name or date range string “d1~d2;d3~d4;d5;...” (date string (M/d/yyyy hh:mm:ss) or count of milliseconds).
These dates extend the displayed date range in chart when needed
The end date of range can be last date or last unit, depending on GanttEndLast setting.
<C><cell> string GanttFlowComplete Gantt source – column name or exact value new 6.4 .
% of completion (0 – 100) of the task, can be column name or float.
When set, the flow replaces the main task! It should not be used with main task!
This attribute is intended to use when the main task should be able to contain more parts, to replace it by Flow.
Remember, to attach dependencies to Flow instead of main task you need to set GanttObject=’Flow’.
It is possible also to define milestone as range with only one part and with the range separator,
for example "1/1/2000~" is start milestone, "~1/1/2000" is end milestone and "1/1/2000" is standard bar part one unit wide.
Since 7.0 for calculating summary of the GanttFlow can be used ganttpercent Formula function.
<C><cell> int GanttFlowJoin [1] new 7.0 .
By default, when set to 1, the overflowed and adjacent parts are automatically merged to one part.
When set to 0, the Flow can contain adjacent part and parts cannot be moved or resized through another part.
When set to -1, the Flow can contain adjacent and also overflowed parts, the parts can be moved or resized through another part.
If set GanttFlowJoin to 0 or -1, the Flow should not be editable by calendar, because it does not support adjacent or overflowed parts.
<C><cell> string GanttFlowText Gantt source – column name or exact value new 6.0 .
Text displayed as tooltip when mouse hovers real flow bar.
<C><cell> string GanttFlowTip new 6.4 .
Tip shown on mouse hover the flow bar. It can contain HTML code.
By default it shows the value of GanttFlowText.
It can also show values from other cells in row, set by *col* where col is the column name.
It can show also the specials: *Text* - show the GanttFlowText, *Start* - start date of the bar, *End* - end date of the bar, *Duration* - length of the bar, *Index* - the bar index (from 1)
Example: “*Index*. *Start* - *End*<br>*Text*”
formula string sumflow (string col = null, string condition = null, int type = 0, string server = null) new 7.0 .
Sums all dates in column with Range=1 Type=”Date”. It just creates new range from all intervals and updates it to not contain duplicate value cross intervals.
The difference to sumrange is that sumflow considers GanttEndLast=’1’
For its attributes see sum function.
<Actions> MoveGanttFlow Attached to OnDragGantt, cannot be attached anywhere else new 7.0 .
Moves one flow bar by mouse dragging.
Fails, if mouse is not above flow bar or the flow bar cannot be moved
<Actions> ResizeGanttFlow Attached to OnDragGantt, cannot be attached anywhere else new 7.0 .
Moves one flow bar by mouse dragging
Fails, if mouse is not above flow bar edge or the flow bar cannot be resized
<Actions> CreateGanttFlow Attached to OnDragGantt, cannot be attached anywhere else new 7.0 .
Creates new flow bar by mouse dragging.
Fails, if flow bar cannot be created here
<Actions> DeleteGanttFlow Attached to OnCtrlClickGantt event .
Deletes one Flow bar under mouse cursor
It fails if there is no Flow under mouse cursor.
<Actions> NewGanttFlowMilestone Attached to OnDblClickGantt event new 7.0 .
Adds new Flow milestone defined by start on mouse position. There can be more milestones defined by Flow in one cell.
<Actions> NewGanttFlowEndMilestone Not attached to any event new 7.0 .
Adds new Flow milestone defined by end on mouse position. There can be more milestones defined by Flow in one cell.
<Actions> SetGanttFlowPercent Attached to OnCtrlRightClickGantt event new 7.0 .
Changes % of completed to position under mouse cursor.
It fails if mouse is not above Flow bar.
<Actions> EditGanttFlowPercent Attached to OnShiftRightClickGantt event new 7.0 .
Lets a user to edit percentage completion of main bar or milestone under mouse cursor.
<Actions> EditGanttFlowText Attached to OnDblClickGantt event new 6.0 .
Lets a user to edit tooltip text of real flow bar under mouse cursor.
Information for date(s) - one or more different icons with tooltip per row
Defined by GanttFlags (date ranges) and GanttFlagTexts (texts for individual flags, displayed as tooltip).
Shows icons on defined dates and displays tooltip when mouse hover the icon
<C><cell> string GanttFlags Gantt source – column name or exact value .
A list of dates (separated by semicolon) where to display a flag with information specified by GanttFlagTexts.
It can be column name, a list of date string (M/d/yyyy hh:mm:ss) or a list of counts of milliseconds
<C><cell> string GanttFlagTexts Gantt source – column name or exact value .
A list of information for the individual flags. Separated by semicolon. This information is shown as hint (TITLE) for the flag. It can be column name or a list of strings
<C><cell> string GanttFlagIcons Gantt source – column name or exact value new 6.1 .
A list of icons for the individual flags. Separated by semicolon. The icon is the exact url of the icon.
<C><cell> string[*] GanttFlagIconList new 6.1 .
A list of predefined icons. The icon is the exact url of the icon. First character separated array.
This list is shown in popup menu to choose the flag icon.
<C><cell> string[*] GanttFlagIconNames new 6.1 .
It contains menu item names for the GanttFlagIconList. First character separated array.
The item name can contain %d to be replaced by the icon from IconList.
If not defined, the exact icon is shown as the item.
<C><cell> string GanttFlagsTip new 6.4 .
Tip shown on mouse hover the flag. It can contain HTML code.
By default it shows the value for the flag from GanttFlagTexts.
It can also show values from other cells in row, set by *col* where col is the column name.
It can show also the specials: *Text* - show the GanttFlagTexts, *Start* - date of the flag, *Index* - the flag index (from 1)
Example: “*Index*. *Start*<br>*Text*”
<Actions> MoveGanttFlag Attached to OnDragGantt, cannot be attached anywhere else new 7.0 .
Moves flag by mouse dragging.
Fails, if mouse is not above flag or the flag cannot be moved.
<Actions> NewGanttFlag Attached to OnDblClickGantt event .
Adds new flag on mouse position and lets a user edit its text.
<Actions> DeleteGanttFlag Attached to OnCtrlClickGantt event .
Deletes one flag under mouse cursor.
It fails if there is no flag under mouse cursor
<Actions> EditGanttFlag Attached to OnDblClickGantt event .
Lets a user to edit text of flag under mouse cursor.
It fails if there is not flag under mouse cursor.
<Actions> ChooseGanttFlagIcon Not attached to any event new 6.1 .
Lets a user to choose icon of the flag under mouse cursor. The possible icons are defined by GanttFlagIconList and GanttFlagIconNames.
Point at date(s) - one or more different movable bullets
<C><cell> string GanttPoints Gantt source – column name or exact value new 6.4 .
The GanttPoints can be defined by four ways:
- Comma separated list of column names where are the individual values stored, for example GGanttPoints=’A,B,C’ A=’1/1/2000’ B=’2/1/2000’ C=’4/2/2000’
- Column name where are the column names stored, for example GGanttPoints=’X’ X=’A,B,C’ A=’1/1/2000’ B=’2/1/2000’ C=’4/2/2000’
- Direct list of values, comma or semicolon separated, it is not changeable, for example GGanttPoints=’1/1/2000;2/1/2000;4/2/2000’
- Column name where are the direct values stored, for example GGanttPoints=’X’ X=’1/1/2000;2/1/2000;4/2/2000’
Only the last definition supports checking exclude and constraints when editing the source cell.
<C><cell> string GanttPointsIcons Gantt source – column name or exact value new 6.4 .
A list of icons for the individual points, in the same order. Separated by comma or semicolon. The icon is the exact url of the icon.
It can be also one of predefined classes 1 – 8, defined in Grid.css as GxGanttPoint1 – GxGanttPoint8:
1 – black, 2 – red, 3 – blue, 4 – green, 5 – pink, 6 – yellow, 7 – light blue, 8 - gray
For example GanttPointsIcons=”1;4;Red.gif;Green.gif;6;Blue.gif”
<C><cell> string[] GanttPointsEdit new 6.4; upd 7.0.
If the individual points can be changed by a user. Comma separated list of 0/1/2 values.
0 – not editable, 1 fully editable, 2 (since 7.0) can move, but cannot delete
<C><cell> string GanttPointsTip new 6.4 .
Tip shown on mouse hover the point. It can contain HTML code.
It can also show values from other cells in row, set by *col* where col is the column name.
It can show also the specials: *Start* - date of the point, *Index* - the point index (from 1), *Col* - name of the column where the point value is stored
Example: “*Col* = *Start*”
<C> int GanttPointsShift [3] new 6.4 .
Minimal distance between adjacent points.
If points are on the same place, the next will be shifted right for this value
<Actions> MoveGanttPoint Attached to OnDragGantt, cannot be attached anywhere else new 7.0 .
Moves point by mouse dragging.
Fails, if mouse is not above point or the point cannot be moved.
<Actions> NewGanttPoint Attached to OnDblClickGantt event new 6.4 .
Adds new point on mouse position.
<Actions> DeleteGanttPoint Attached to OnCtrlClickGantt event new 6.4 .
Deletes the point under mouse cursor.
It fails if there is no point under mouse cursor
Mark line, e.g. actual date - one or more vertical lines per row, not editable
Defined by GanttMark (date ranges).
It is a mark line showing some important date or deadline. It is often the same for whole column, but it need not be.
It is displayed above the other Gantt items, so the line should not be too thick.
It cannot be dynamically changed by a user, only by API.
<C><cell> string GanttMark Gantt source – column name or exact value upd 7.0 .
Other times to mark in chart, useful for displaying actual date or vertically divide chart to bigger units or mark weekends and so on.
It can be column name or date range string “d1~d2;d3~d4;d5;...” (date string (M/d/yyyy hh:mm:ss) or count of milliseconds).
These dates do not extend the displayed date range in chart. When the date is outside the actual displayed range in chart, it is not shown.
Since 7.0 the dates can have postfix #cls to display in css class GxGanttMarkX with the cls index. It cannot be used for Mark set as column! For example GanttMark=’1/1/2000#2;1/7/2000#5’.
There are predefined color classes 1 - 5 with full height, 6 - 8 bottom bars, 9 - 11 top bars, 12 - 14 middle lines
<C><cell> string GanttMarkRound [‘m’] .
Mark rounding, to these units will be all dates in GanttMark rounded, possible values are the same as GanttUnits.
To display just thin vertical lines, set it to ‘m’, for thicker lines higher the value according to actual GanttUnits used.