Task's General Properties

Tasks can be identified by a number of general properties, such as name, ID, start and finish date. Aspose.Tasks can be used to get and set task properties when working with projects.

Overview

The static class Tsk contains all the properties related to a Task and can get or set using the Get and Set methods exposed by Task class. Some of the commonly used properties are as follow:

• Name, used to set and get a task’s name (string).
• Id, used to set and get a task’s ID (integer).
• Uid, used to set and get a task’s unique ID (integer).
• Start, used to set and get a task’s start date (DateTime).
• Finish, used to set and get a task’s end date (DateTime).

To view a task’s general properties in Microsoft Project:

1. Open a project.
2. On the View menu, select More Views and then Task Entry to open the task entry form.
3. From the Insert menu, select Column and add the ID and Unique ID.

Setting General Properties

The code example given below demonstrates how to set general properties.

// Create project instance
System::SharedPtr<Project> project = System::MakeObject<Project>();
    
// Add task and set task properties
System::SharedPtr<Task> task = project->get_RootTask()->get_Children()->Add(u"Task1");
task->Set(Tsk::Start(), project->get_RootTask()->Get<System::DateTime>(Tsk::Start()).AddDays(1));
task->Set<System::String>(Tsk::Name(), u"new name");

Getting General Properties

Get a task’s properties by traversing the children of the project’s RootTask property.

// 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"ReadTaskProperties.mpp");
    
// Create a ChildTasksCollector instance
System::SharedPtr<ChildTasksCollector> collector = System::MakeObject<ChildTasksCollector>();
    
// Collect all the tasks from RootTask using TaskUtils
TaskUtils::Apply(prj->get_RootTask(), collector, 0);
    
// Parse through all the collected tasks
    
{
    auto tsk_enumerator = (collector->get_Tasks())->GetEnumerator();
    decltype(tsk_enumerator->get_Current()) tsk;
    while (tsk_enumerator->MoveNext() && (tsk = tsk_enumerator->get_Current(), true))
    {
        System::Console::WriteLine(u"Task Id: {0}", System::ObjectExt::Box<int32_t>(tsk->Get<int32_t>(Tsk::Id())));
        System::Console::WriteLine(u"Task Uid: {0}", System::ObjectExt::Box<int32_t>(tsk->Get<int32_t>(Tsk::Uid())));
        System::Console::WriteLine(u"Task Name: {0}", System::ObjectExt::Box<System::String>(tsk->Get(Tsk::Name())));
        System::Console::WriteLine(u"Task Start: {0}", System::ObjectExt::Box<System::DateTime>(tsk->Get<System::DateTime>(Tsk::Start())));
        System::Console::WriteLine(u"Task Finish: {0}", System::ObjectExt::Box<System::DateTime>(tsk->Get<System::DateTime>(Tsk::Finish())));
    }
}