GanttExtension Class

The Gantt extension.

Namespace: DevExpress.Web.Mvc

Assembly: DevExpress.Web.Mvc5.v20.1.dll

Declaration

public class GanttExtension :
    ExtensionBase
Public Class GanttExtension
    Inherits ExtensionBase

Remarks

The Gantt allows you to display the task flow and dependencies between tasks.

DevExpress ASP.NET MVC Gantt extension

Declaration

To declare the Gantt in a View, invoke the Gantt(GanttSettings) or Gantt(Action<GanttSettings>) helper methods. These methods return the Gantt extension that is implemented by the GanttExtension class.

To configure the Gantt extension, pass the GanttSettings object to the Gantt(GanttSettings) helper method as a parameter. The GanttSettings object contains all the Gantt extension settings.

@Html.DevExpress().Gantt(settings => {
    settings.Name = "gantt";
    settings.CallbackRouteValues = new { Controller = "Gantt", Action = "FeaturesPartial" };
    settings.Width = Unit.Percentage(100);

    settings.KeyFieldName = "ID";
    settings.ParentFieldName = "ParentID";
...
}).Bind(
    GanttDataProvider.Tasks, 
    GanttDataProvider.Dependencies, 
    GanttDataProvider.Resources, 
    GanttDataProvider.ResourceAssignments
).GetHtml()

Features

Data-Bound Mode

The Gantt can operate only in bound mode. Bind the extension to a data model that provides data for tasks. It supports standard data source types, including SqlDataSource, ObjectDataSource, XmlDataSource, AccessDataSource, and SiteMapDataSource.

The extension requires data tables for tasks, resources, resource assignments, and dependencies. Mappings (Mappings) specify which field in a data table corresponds to an object's property (task, dependency, resource).

See demo

Edit Tasks

The Gantt supports the following edit operations (SettingsEditing):

  • Resize and modify tasks.

  • Modify resources.

  • Add and remove dependencies between tasks and assignments.

  • Edit cell values within the Task List. The control saves changes on the server and updates the Gantt chart when cell values change.

The Gantt stores changes made by end users. It allows you to roll back the last change when necessary.

See demo

Column Types

You can add columns (Columns) to the Task List to display display different data types.

settings.SettingsTaskList.Columns.Add(
    new GanttTextColumn() { 
        FieldName = "Subject", 
        Caption = "Title", 
        Width = Unit.Pixel(360) 
    }
);

Learn more | See demo

Scale Tasks

Use the ViewType property or SetViewType(viewType) method to switch between display types: Ten Minutes, Thirty Minutes, Hours, Days, Weeks, and Months. It allows you to change date intervals on a timescale. Hold the CTRL key and rotate your mouse's scroll wheel to zoom.

settings.SettingsGanttView.ViewType = GanttViewType.Weeks;

Learn more | See demo

Custom Work Time

You can specify the work and non-work time intervals, as well as custom workdays and holidays.

The work time settings are stored in the WorkTimeRules collection. The following rules are available:

Each rule can contain work time ranges and recurrence settings.

var dailyRule = new DevExpress.Web.ASPxGantt.DailyRule();
dailyRule.WorkTimeRanges.Add(
    new DevExpress.Web.ASPxGantt.WorkTimeRange() { 
      Start = new TimeSpan(8, 0, 0), 
      End = new TimeSpan(11, 55, 00) 
    }
);
settings.WorkTimeRules.Add(dailyRule);

Learn more | See demo

Task Title Position

The control supports the following task title display types (TaskTitlePosition): hidden, within a task, and next to a task.

settings.SettingsGanttView.TaskTitlePosition = GanttTaskTitlePosition.Outside;

Learn more | See demo

Validation

You can recalculate the duration and progress of parent tasks (EnableDependencyValidation), and validate relationships between all tasks (AutoUpdateParentTasks), when a task is modified.

settings.SettingsValidation.EnableDependencyValidation = true;
settings.SettingsValidation.AutoUpdateParentTasks = true;

Learn more | See demo

Strip Lines

Use strip lines (StripLine) to highlight specific times (or time intervals) in the Gantt chart.

settings.SettingsStripLine.StripLines.Add(new StripLine() { 
    Start = new DateTime(2019, 02, 21) 
});

Learn more | See demo

Toolbar

The toolbar (Visible) can display frequently used commands.

settings.SettingsToolbar.Items.Add(new GanttCollapseAllToolbarItem() { Text = "Collapse All" });
settings.SettingsToolbar.Items.AddCustomItem(i => {
    i.Text = "About";
    i.CommandName = "About";
    i.BeginGroup = true;
    i.Image.IconID = "iconbuilder_actions_info_svg_gray_16x16";
});
settings.SettingsToolbar.Visible = DemoOptions.ShowToolbar;

Learn more | See demo

Inheritance

Object
ExtensionBase
GanttExtension
See Also