Changes from 9.3 to 10.0 in Gantt chart
TreeGrid documentation
This document describes only changes in compatibility between TreeGrid 9.3 and TreeGrid 10.0.
This document does not describe new features of TreeGrid 10.0.
Incompatibilities
These items must be changed to work like in previous version
Gantt chart is not resized according to side text by default.
GanttShowHtml and
GanttRunShowHtml are set to
1 by default, to not resize Gantt column width according to side text, if set
GanttSize="" or
"0".
Set them to
3 for 9.3 behavior used for GanttFormat.
Dependency must have defined bar plan if more plans are permitted for dependencies.
If more bar types (more main bar plans and / or run) support dependencies, the dependency definition must contain the bar identification (number for main bar plan or '-' for run bar). Like
"1,1@R1", where 1,1 is the from and to plan number.
Only the first object in
GanttTask (formerly GanttObject) need not have this identification.
In 9.3 version only the first bar defined in row had dependencies and no identification was required.
Dependency API changed, the dependency API definition is different.
Changed
OnGetDependency,
OnCheckDependencies,
GetIncorrectDependencies,
GetIncorrectConstraints,
GetTasksToSchedule,
OnCorrectDependencies.
API
GetDependency and
SetDependency deleted and replaced by
GetDependencies,
DeleteDependencies,
AddDependencies and
TestDependencies.
GetGanttXY returns different values for dependency.
Scheduling algorithm was rewritten.
It can produce different results than 9.3. version especially due different meaning of
GanttStrict options.
The tasks with none of dependency, dependencycorrect and bar ...correct in
GanttEdit are ignored when scheduling, including their relation (dependencies and children).
GanttResources for Run was renamed to GanttRunResources.
GanttResources are now used only for the first main bar plan and due compatibility also for GanttFlow.
GanttSummary for Run was renamed to GanttRunSummary.
GanttComplete (GanttFlowComplete) / GanttRunComplete is used only if the bar is included in GanttTask (GanttObject).
OnGetGanttHtml does not change the main bar class to Html.
In 9.3. if OnGetGanttHtml API event returned not null, the bar class was set to Html, without border and background.
Now you must explicitly set the
GanttClass/X to "Html", "Void" or "None" to change the class for the bar.
By default the Sort and Calc buttons on Toolbar are hidden.
You can show them by setting
<Toolbar SortVisibleFormula='1' CalcVisibleFormula='1'/>
Empty Run box is not shown by default, even if it has set Text or Class.
Set
<C GanttRunEmpty='1'/> to show it in this case.
OnGetGanttRunRect is called also when calculating dependencies.
For milestone the GanttDuration column value is set to 0 or "" according to CanEmpty value regardless on the cell Type.
GanttClass is now used only for the first main bar plan.
Run has GanttRunClass or Run Class and other main bar plans have their own GanttClassX attribute.
CSS style sheet for Gantt chart was rewritten.
The Gantt CSS was separated from Grid.css to its own file Gantt.css.
Many of the CSS classes renamed, deleted or created new.
Gantt internal HTML height was increased from 500 to 5000 pixels to support rows higher than 500 pixels.
If you used customized CSS for Gantt, you need to rewrite it completely, based on the new TreeGrid Gantt.css.
The Run FastGantt is now boolean and affects all browsers.
OnGanttMenuClick is called for all items, not only for custom ones.
Various changes in TreeGrid (not only Gantt).
Some of previous HTML ids used by TreeGrid were changed, especially in Gantt objects.
Copying,
CopyDeleted,
CanCopy and
Copy attributes are now used also when copying rows between grids by dragging.
The exported HTML is now in UTF8 also in IE5,6,7,8, regardless on the page encoding.
Hover classes in CSS for space Bool and Select types were modified and renamed.
Deprecated items
These items work also in the new version, but it is strongly recommended to use them in the new way
GanttSummary should be set to main bar plan, 0 for first plan.
In 9.3. the GanttSummary was set to 1 for all bars, or to 2 for all editable bars.
For editable summary should be set GanttSummaryType instead of GanttSummary = 2.
GanttFlow should be replaced by GanttParts.
The Flow bar was removed and should be replaced by main bar. It is possible to have more main bar plans and also discrete main bars.
Set also
GanttCount=2 or more if you want to have two main bar plans (formerly main bar and flow together).
Rename or update also other Flow attributes to main bar attributes.
GanttFormat should be replaced by bar side text.
Use
GanttHtmlLeft/X or
GanttHtmlRight/X for main bar or
GanttRunHtmlLeft or
GanttRunHtmlRight for run bar.
GanttFormatObject is replaced by
GanttHtmlLeftEdge/X or
GanttHtmlRightEdge/X for main bar or
GanttRunHtmlLeftEdge or
GanttRunHtmlRightEdge for run bar.
Scheduling algorithm was rewritten.
GanttStrict option 2 has been replaced by manual date (
GanttManual,
GanttRunManual, GanttRun -
Manual).
GanttObject renamed to GanttTask.
By default only the first main bar plan is set as Gantt task and provides dependencies, resources, completion state, manual constraint and locked / disabled state.
ZoomToPage in Pager was replaced by attributes Click and DblClick.