Task Calendars

It is possible to associate calendars with particular tasks in Microsoft Project. Aspose.Task supports this functionality.

Tasks with Calendars

The Tsk class exposes the Calendar field used to set or get the calendar associated with a task. This property accepts or returns an Aspose.Tasks.Calendar object.

To create a calendar for a task in Microsoft Project:

1. Open a project in Microsoft Project.
2. On the Project menu, select Change Working Times, then Create New Calendar.
3. To assign the calendar to a task, double-click the task in the Task Entry form.
4. Select the Advanced tab.

Setting Task Calendar

Create a standard calendar and create a task. Assign the Calendar to the task.

// Create project instance
System::SharedPtr<Project> project = System::MakeObject<Project>();
    
// Add task
System::SharedPtr<Task> tsk1 = project->get_RootTask()->get_Children()->Add(u"Task1");
    
// Create calendar and assign to task
System::SharedPtr<Aspose::Tasks::Calendar> cal = project->get_Calendars()->Add(u"TaskCal1");
tsk1->Set<System::SharedPtr<Calendar>>(Tsk::Calendar(), cal);

Getting Task Calendar

Get task calendar by traversing the tasks in a project.

// The path to the documents directory.
System::String dataDir = RunExamples::GetDataDir(System::Reflection::MethodBase::GetCurrentMethod(ASPOSE_CURRENT_FUNCTION)->get_DeclaringType().get_FullName());
    
// Create project instance
System::SharedPtr<Project> prj = System::MakeObject<Project>(dataDir + u"ReadTaskCalendar.mpp");
    
// Declare ChildTasksCollector class object
System::SharedPtr<ChildTasksCollector> collector = System::MakeObject<ChildTasksCollector>();
    
// Use TaskUtils to get all children tasks in RootTask
TaskUtils::Apply(prj->get_RootTask(), collector, 0);
    
// Parse all the recursive children
    
{
    auto tsk_enumerator = (collector->get_Tasks())->GetEnumerator();
    decltype(tsk_enumerator->get_Current()) tsk;
    while (tsk_enumerator->MoveNext() && (tsk = tsk_enumerator->get_Current(), true))
    {
        System::SharedPtr<Calendar> tskCal = tsk->Get<System::SharedPtr<Calendar>>(Tsk::Calendar());
        System::Console::WriteLine(u"Task calendar name: {0}", System::ObjectExt::Box<System::String>(tskCal == nullptr ? u"None" : tskCal->get_Name()));
    }
}