3. Paging in Gantt chart

Paging options for Gantt chart

• Horizontal paging by side pagers

  
  Horizontal paging in Gantt chart is always client side, fully managed by TreeGrid.
  The Gantt side pagers can be displayed also with grid pager (type Pages) for root rows and also with custom side pagers.
  See documentation for Side pager type Gantt and documentation for Pager.
  
  • Define one or more

    side Gantt pagers

    by

    <Pager Type='Gantt'>

    in root tag <Pagers> ... </Pagers>. Pager side can be chosen by its attribute Left.
    Specify <Pager> attributes

    PageSize

    as GanttUnits for every page size and

    ChartSize

    as GanttUnits for the whole pager size.
    By <Pager> attributes ChartLeft and ChartRight you can optionally add next pages on beginning and at the end of the pager to extend ChartSize range.
    By <Pager> attributes

    Click

    and

    DblClick

    specify the action done on click or double click to pager page. How the chart will be scrolled or zoomed.
    Optionally define <Pager> attributes FirstZoom and LastZoom to show the pager only on specified zoom levels and hide it in all others.
    See documentation for Side pager type Gantt for more options.
    
  • Optionally define one or more

    zoom levels

    by

    <Z>

    tags in root tag <Zoom> ... </Zoom>.
    For every zoom level define Name, GanttUnits, GanttWidth, GanttHeader1(-5) and optionally GanttSize or GanttChartRound, and GanttBackground.
    Initial zoom and position in Gantt define by <C> attributes GanttZoom and GanttZoomDate.
    To not show horizontal scrollbars and let the Gantt to fit its width (like in the second grid) set <C> attribute GanttSizeFit='1' and optionally GanttSmoothZoom='0'.
    See documentation for Zoom options, Zoom selection and Chart size limits
    
  • It is possible to define

    custom Gantt units

    to be used in PageSize, ChartSize, GanttUnits, GanttHeader, GanttBackground and so on. The custom units cannot be used in GanttExclude.
    The custom units can have even variable size, e.g. this example defines custom units 'wh' as work hours 9:00 - 13:00, 13:00 - 14:00, 14:00 - 18:00, 18:00 - 9:00, see it in top grid in zoom level "All in workhours".
    The custom units are created by global API function AddGanttUnits that should be called before any Gantt chart is created.
    If the custom units have variable length or don't start on 1/1/1970 00:00:00, they must be calculated in API events OnRoundDate and OnIncDate.
    See documentation for Custom Gantt units.
    

• Horizontal paging by scroll

  
  Renders only visible (due horizontal scroll) part of Gantt chart.
  • To switch on the paging by scroll set <C> attribute

    GanttPaging

    ='1' of <C> Gantt column.
  • By <C> attribute GanttPagingFixed you can control paging of head rows, foot rows and Gantt background. The part can be displayed for the whole chart or rendered only for actual page.
    By default is background and foot rows. And Gantt headers can be paged individually by their GanttHeaderPaging1-5 attributes.
    
  • For Gantt paging is set the default maximal width to 1 193 049 pixels. If the width of the whole displayed Gantt chart becomes wider, it is cut to the maximal width.
    The maximal Gantt width can be increased by <C> MaxWidth attribute, but it will be shrunk in IE browser to its hard limits. 1 193 049 is limit for IE8 strict, 1 342 177 for IE8 quirks and 1 533 918 for other IE versions.
    
  • See documentation for Horizontal paging by scroll for more options.
    

• Vertical paging of rows

  
  Grid with Gantt chart can have rows paged vertically like normal grid. Can be also freely combined with horizontal Gantt paging.
  • Render root rows on scroll, see documentation for Paging root rows or tutorial 01-Client_root_paging.
  • Render children on expand, see documentation for ChildPaging or tutorial 02-Client_child_paging.
  • Render children on scroll, see documentation for ChildParts or tutorial 02-Client_child_paging.
  • Load root rows on scroll, see documentation for Server paging root rows or tutorial 06-Server_root_paging.
  • Load children on scroll, see documentation for Server ChildPaging or tutorial 07-Server_child_paging.
  • Gantt chart restrictions in server paging (loading rows on demand)
    
    • Dependencies cannot be linked between tasks in different pages or child pages.
    • Resource charts cannot be calculated from not yet loaded tasks.
    • Chart size cannot be calculated from not yet loaded tasks (GanttSize should not be "" or "0").
    • GanttBase and GanttFinish cannot be automatically calculated from not yet loaded tasks.
    • All Formula summary Gantt functions, e.g. ganttstart(), cannot be calculated from not yet loaded tasks.