Outline Properties

Microsoft Project has an outline structure that let users get a quick overview of a project. Aspose.Tasks for C++ API supports this functionality and lets developers control the outline number - where the task appears in a hierarchy - and the outline level - which level of the hierarchy the task is in.

Working with Outline Properties

The Tsk class exposes the OutlineNumber and OutlineLevel properties for managing outlines associated with a class:

1. OutlineNumber (string).
2. OutlineLevel (integer).

Outlines in Microsoft Project

In Microsoft Project, outline number and outline level properties can be viewed on the Task Entry form by adding the columns:

1. On the Insert menu, select columns.
2. Add the OutlineNumber and OutlineLevel columns.

Getting Outline Properties in Aspose.Tasks

The following example shows how to get the outline level and outline number information about a task 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"TaskOutlineProperties.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);
    
// Parse through all the collected 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" - Outline Level : " + tsk1->Get<int32_t>(Tsk::OutlineLevel()));
        System::Console::WriteLine(tsk1->Get(Tsk::Name()) + u" - Outline Number : " + tsk1->Get(Tsk::OutlineNumber()));
    }
}