TreeGrid v6.3

Gantt objects

TreeGrid documentation index

 

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)

 

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

Exclude                           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="$&lt;span style='color:#77F'>*P*&lt;/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.

ObjectGanttObject 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.

 

Edit settings

 

<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*&lt;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.

 

Milestone

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 Flow

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*&lt;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.

 

Flag

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*&lt;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

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

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.