Work with Task Priorities

A task’s priority helps Microsoft Project with automatic resource levelling (a process of fixing conflicts when a resource is over-allocated). In Microsoft Project, it is possible to assign priority values between 0 and 1000 (where 0 is the lowest priority). By default, tasks are assigned the value 500.

Working with Priorities

The priorities associated with a class are handled through the Priority property exposed by the Tsk class.

• Priority: a task’s priority (an integer between 1 and 1000).

Priorities in Microsoft Project

To check a task’s priority in Microsoft Project one need to double-click a task in the Task Entry form:

Task priority in Microsoft Project

Getting a Task’s Priority

The code example given below demonstrates how to get a task’s priority and write it to a console window using Aspose.Tasks.

// Read project from file stream
System::String dataDir = RunExamples::GetDataDir(System::Reflection::MethodBase::GetCurrentMethod(ASPOSE_CURRENT_FUNCTION)->get_DeclaringType().get_FullName());
System::SharedPtr<System::IO::FileStream> fs = System::MakeObject<System::IO::FileStream>(dataDir + u"TaskPriority.mpp", System::IO::FileMode::Open);
System::SharedPtr<Project> prj = System::MakeObject<Project>(fs);
fs->Close();
    
// 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);
    
// Display Priorities for all tasks
    
{
    auto tsk1_enumerator = (collector->get_Tasks())->GetEnumerator();
    decltype(tsk1_enumerator->get_Current()) tsk1;
    while (tsk1_enumerator->MoveNext() && (tsk1 = tsk1_enumerator->get_Current(), true))
    {
        System::Console::WriteLine(tsk1->Get(Tsk::Name()) + u" - Priority : " + System::Convert::ToString(tsk1->Get<int32_t>(Tsk::Priority())));
    }
}