Tasks Configuration Overview

Topic Overview

Purpose

This topic gives an overview of the xamGantt™ ProjectTask class and its configurable aspects.

Required background

The following topics are prerequisites to understanding this topic:

Topic	Purpose
xamGantt Overview	This topic describes basic conceptual information about xamGantt, project, tasks and other xamGantt elements.
xamGantt in Detail	This group of topics describes the xamGantt control in details.

In this topic

This topic contains the following sections:

Introduction
Project Task Configuration Properties Summary
Project Task Calculated and Read-Only Properties Summary
Project Task Methods Summary
Related Content

Introduction

ProjectTask class summary

The ProjectTask object represents a single task in a Project in the xamGantt control.

Every project has one root task, and that is the summary project task. All tasks associated with the project are descendants of that task.

Project Task Configuration Properties Summary

Project task configuration properties summary chart

The following table lists some of the main configurable aspects of the xamGantt ProjectTask.

Configurable aspect	Details	Properties
Configuring a task’s constraint	Returns or sets the date (UTC) and type of a task constraint.	ConstraintDate ConstraintType
Configuring a task’s deadline	Returns or sets a deadline date for completing a task in Coordinated Universal Time (UTC).	Deadline
Configuring a task’s duration and duration format	Returns or sets task duration and duration format.	Duration DurationFormat
Configuring a task’s finish date	Returns or sets the finish date in Coordinated Universal Time (UTC).	Finish
Configuring if a task is active or inactive	Returns or sets a task’s state (active/inactive).	IsActive
Configuring a taskbar visibility	Returns or sets a Boolean value indicating if a task bar is visible in the xamGantt chart section.	IsBarHidden
Configuring a task’s mode (automatically/manually scheduled)	Returns or sets a Boolean value indicating whether task scheduling occurs manually or automatically.	IsManual
Configuring a milestone	Returns or sets a Boolean value indicating if a task represents a major event in the project and should be marked as a milestone.	IsMilestone
Configuring task’s duration, start and finish dates based on specified number of units and unit type	Returns or sets duration, start and finish dates. Displays the `ManualStart` and `ManualFinish` values in xamGantt grid section’s Start and Finish columns. Example: Setting a task’s duration of 5 days using the ProjectDuration FromFormatUnits method: `ManualDuration = ProjectDuration.FromFormatUnits(5, ProjectDurationFormat.Days)` Setting a free formatted text in the Finish date column for a manually scheduled task using the ManualDateTime constructor: `ManualFinish = new ManualDateTime(“Not Defined Yet”)`	ManualDuration ManualFinish ManualStart
Configuring a task’s progress	Returns or sets a value between 0 and 100, inclusively, representing the percentage of the ManualDuration completed.	PercentComplete
Configuring a task’s predecessors	Use the `Add` method to set task predecessors in the Predecessors collection; or set/get a string representing the predecessors by ID via the PredecessorsIdText.	Predecessors PredecessorsIdText
Configuring a task’s resources	Use the `Add` method to set task resources in the Resources collection; or set/get a string representing the resources via the ResourcesText.	Resources ResourcesText
Configuring the scheduled duration, start and finish for a task	Returns or sets the total span of a task’s active working time; scheduled start and scheduled finish dates expressed in Coordinated Universal Time (UTC).	ScheduledDuration ScheduledFinish ScheduledStart
Configuring a task’s start date	Returns or sets task start date in Coordinated Universal Time (UTC).	Start
Configuring a task’s successors	Use the `Add` method to set task successors in the Successors collection; or set/get a string representing the successors by ID via the SuccessorsIdText.	Successors SuccessorsIdText
Configuring a task’s name	Returns or sets the name of the task.	TaskName
Configuring the collection of child tasks	Returns the collection of child tasks.	Tasks

Project Task Calculated and Read-Only Properties Summary

Project task calculated properties summary chart

The following table lists some of the main calculated properties of the xamGantt ProjectTask.

Property	Description
EarlyFinish	Returns the earliest calculated date that a task could finish based on its predecessors and constraints.
EarlyStart	Returns the earliest calculated date that a task could start based on its predecessors and constraints.
FinishSlack	Returns task’s calculated duration between the task’s `EarlyFinish` and `LateFinish` dates.
FreeSlack	Returns the calculated amount of delay time a task can incur without delaying any successors or affecting the project’s finish date.
Id	Returns the task’s assigned calculated identifier number.
Index	Returns the task’s current index within the Tasks of the Parent.
IsCritical	Returns a Boolean value indicating if the task is on the project’s critical path.
IsSummary	Returns a Boolean value indicating if the task is a summary task.
LateFinish	Returns the calculated latest date that a task could finish without delaying the project finish.
LateStart	Returns the calculated latest date that a task could begin based on the predecessors, successors and constraints without delaying the project.
Project	Returns the associated project containing the task.
TotalSlack	Returns the calculated total amount of delay time that a task can incur without delaying the project.

Project Task Methods Summary

Project task methods summary chart

The following table lists some of the main methods of the xamGantt ProjectTask.

Method	Description
Delete	Deletes the task along with all of its subtasks.
GetLocal	Obtains the task dates, in local time, based on the specified `TimeZoneToken`.
Indent	Removes the task from its current parent and make it a child of the previous sibling task.
Outdent	Removes the task from its current parent and make it a sibling of the parent.
RespectLinks	Forces the scheduling engine to update the Start and Finish dates of a manual task respecting its dependencies, constraint, and deadline.
SetLocal	Sets the task dates, in local time, based on the specified `TimeZoneToken`.

Topic	Purpose
Configuring Tasks as Manual/Automatic	This topic explains how to configure a task to either manual or automatic scheduling using the xamGantt control.
Configuring Tasks as Active/Inactive	This topic explains how to configure a task as either active or inactive using the xamGantt control.
Configuring Deadlines	This topic explains how to configure task deadlines using the xamGantt control.
Configuring Milestones	This topic explains how to create a milestone using the xamGantt control.
Configuring Task Progress	This topic explains how to set task progress using the xamGantt control.
Configuring the Task Duration and Duration Format	This topic explains how you can set task duration and task duration unit using xamGantt control.
Configuring Tasks Dependencies	This topic explains how to configure tasks dependencies using the xamGantt control.
Configuring Tasks Constraints	This topic explains how to configure tasks constraints using the xamGantt control.

WPF | Help Topics