Task definition in Gantt Chart Light, Web, and Hyper Libraries for Silverlight/WPF, ASP .NET, and HTML5/JavaScript

At initialization time, task items are defined using these main timing related properties:

• Start: date and time value to start work;
• Finish: date and time value to finish work; if you need to compute it based on the Start value and an effort value, use the GetFinish method provided by the component instance: item.Finish = component.GetFinish(item.Start, effort);
• CompletedFinish: date and time value (between start and finish) indicating the time upon which the work is completed to; if you need to compute it based on the Start value and a completedEffort value, use the GetFinish method provided by the component instance: item.CompletedFinish = component.GetFinish(item.Start, completedEffort); alternatively, to compute it based on the Start value and a percentComplete value, use the GetCompletedFinish method provided by the component instance: item.CompletedFinish = component.GetCompletedFinish(item.Start, item.Finish, percentComplete / 100);
• IsMilestone: indicates whether the current task is a milestone; milestones assume to have equal Start and Finish date and times, and are represented differently in the chart;
• AssignmentsContent: defines resources displayed as assigned to the task in the chart, and their allocation units (for example, both John and Mary may be assigned to the same task, but Mary may use only 50% of its availability for this specific work item, i.e. 0.5 allocation units); by default, if no assignments are specified, allocation units total is considered to be 100% (1): assignments don't affect task scheduling, though (if you need to adapt task duration to its effort and assignments, use custom code to determine the appropriate Finish value);
• Schedule: defines working and nonworking time for the task on the timeline (for example, Monday-Friday 8 AM - 4 PM is working time, each week, no holidays); if schedule is null for a specific task (default situation), the component level schedule definition is used.

• For GanttChartDataGrid control from Gantt Chart Light Library (Silverlight™/WPF):

  GanttChartDataGrid.ApplyTemplate();
  var start = DateTime.Today.Add(TimeSpan.Parse("10:00:00"));
  var effort = TimeSpan.Parse("12:00:00");
  var percentCompleted = 50.0;
  var finish = GanttChartDataGrid.GetFinish(start, effort);
  var completedFinish = GanttChartDataGrid.GetCompletedFinish(start, percentCompleted / 100, finish);
  GanttChartDataGrid.Items.Add(new GanttChartItem {
      Content = "Effort based task", Start = start, Finish = finish, CompletedFinish = completedFinish });

• For GanttChartView control from Gantt Chart Web Library (ASP .NET):

  var start = new DateTime(year, month, 2, 10, 0, 0);
  var effort = TimeSpan.FromHours(12);
  var percentCompleted = 50.0;
  var finish = GanttChartView.GetFinish(start, effort);
  var completedFinish = GanttChartView.GetCompletedFinish(start, percentCompleted / 100, finish);
  GanttChartView.AddItem(new GanttChartItem {
      Content = "Effort based task", Start = start, Finish = finish, CompletedFinish = completedFinish });

• For GanttChartView control from Gantt Chart Hyper Library (JavaScript®):

  var start = new Date(year, month, 2, 10, 0, 0),
      effort = 12 * 60 * 60 * 1000,
      percentCompleted = 50;
  var finish = ganttChartView.getOutputDate(
      ganttChartView.getFinish(ganttChartView.getInputDate(start), effort));
  var completedFinish = ganttChartView.getCompletedFinish(start, percentCompleted / 100, finish);
  ganttChartView.addItem({
      content: "Effort based task", start: start, finish: finish, completedFinish: completedFinish });

At runtime, task items also provide these read/write properties that you can supplementary use:

• Effort: work duration, considered as if a single resource would be fully assigned to perform it (such as 1 day and 4 hours, i.e. 30 work hours);
• TotalEffort: total work effort, considering the assigned resources and allocation units determined from AssignmentsContent string;
• CompletedEffort: completed work duration, considered as if a single resource would be fully assigned to perform it;
• TotalCompletedEffort: total completed work effort, considering the assigned resources and allocation units determined from AssignmentsContent string;
• Completion: ratio between the completed effort and required effort of the task item (between 0 and 1); mulitply it by 100 to obtain a percent completed value.