Робота зі стилями на замовлення

Огляд

У Microsoft Project перегляд діаграми Gantt дозволяє користувачам визначати власні стилі бару для вдосконалення візуалізації або підкреслення конкретних типів завдань. Сюди входить зміна поява барів (старт, середина, кінець), додавання спеціальних кольорів, коригування фігур та налаштування текстових мітків навколо смуг завдань.

Aspose.tasks для .NET підтримує цей рівень налаштування через клас ganttbarstyle. За допомогою цього розробники можуть програмно контролювати, як кожне завдання (або група завдань) відображається у зображеному зображенні діаграми Ганта, що робить звітність та візуальний аналіз більш значущим.

Визначення стилю на замовлення

Щоб визначити новий стиль для певного завдання або набору завдань, ви повинні:

1. Створіть новий екземпляр `ganttbarstyle ‘.
2. Встановіть властивості, такі як ShowfortAskaId, Middleshape, startshape, endshape, fillcolor та інші.
3. Додайте стиль до колекції `ImagesaveOptions.barstyles ‘перед наданням.

Tip: The ShowForTaskUid property specifies which task UID this style applies to. You can also apply a style globally by omitting it.

Приклад: Застосовуйте власний стиль до певного завдання

static void ImplementCustomBarStyle()
{
    Project project = new Project("New Project.mpp");
    project.RootTask.Children.Add("Task");

    GanttChartView view = project.DefaultView as GanttChartView;
    GanttBarStyle custom = GetCustomBarStyle();

    // Add the custom bar style to the custom bar collection of the project view
    view.CustomBarStyles.Add(custom);

    MPPSaveOptions options = new MPPSaveOptions();
    options.WriteViewData = true;

    project.Save("ImplementCustomBarStyle_out.mpp", options);
}

static GanttBarStyle GetCustomBarStyle()
{
    GanttBarStyle style = new GanttBarStyle();
    style.ShowFor = "1";
    style.MiddleShape = GanttBarMiddleShape.RectangleBottom;
    style.MiddleFillPattern = GanttBarFillPattern.MediumFill;
    style.MiddleShapeColor = Color.Blue;

    style.StartShape = GanttBarEndShape.ArrowDown;
    style.StartShapeColor = Color.Red;

    style.EndShape = GanttBarEndShape.ArrowUp;
    style.EndShapeColor = Color.Yellow;

    style.LeftField = Field.TaskResourceNames;
    style.RightField = Field.TaskName;
    style.TopField = Field.TaskStart;
    style.BottomField = Field.TaskFinish;
    style.InsideField = Field.TaskDuration;

    return style;
}

Читання існуючих стилів користувацьких стовпчиків

Aspose.Tasks також дозволяє зчитувати об’єкти GanttBarStyle з існуючих файлів MPP. Це може бути корисним, якщо вам потрібно проаналізувати або відтворити стиль, застосований у Microsoft Project.

Приклад: Читання всіх користувацьких стилів з проекту

Project project = new Project("New Project.mpp");

GanttChartView view = project.DefaultView as GanttChartView;
Console.WriteLine("Custom bar styles count: {0}", view.CustomBarStyles.Count);

GanttBarStyle style1 = view.CustomBarStyles[0];

Console.WriteLine("Style1.LeftField is TaskDurationText : {0}", style1.LeftField.Equals(Field.TaskDurationText));
Console.WriteLine("Style1.RightField is TaskResourceNames : {0}", style1.RightField.Equals(Field.TaskResourceNames));
Console.WriteLine("Style1.TopField is TaskACWP: {0}", style1.TopField.Equals(Field.TaskACWP));
Console.WriteLine("Style1.BottomField is Undefined : {0}", style1.BottomField.Equals(Field.Undefined));
Console.WriteLine("Style1.InsideField is Undefined : {0}", style1.InsideField.Equals(Field.Undefined));

GanttBarStyle style2 = view.CustomBarStyles[1];
Console.WriteLine("Style2.LeftField is TaskActualWork : {0}", style2.LeftField.Equals(Field.TaskActualWork));
Console.WriteLine("Style2.RightField is TaskActualCost : {0}", style2.RightField.Equals(Field.TaskActualCost));
Console.WriteLine("Style2.TopField is Undefined : {0}", style2.TopField.Equals(Field.Undefined));
Console.WriteLine("Style2.BottomField is Undefined : {0}", style2.BottomField.Equals(Field.Undefined));
Console.WriteLine("Style2.InsideField is Undefined : {0}", style2.InsideField.Equals(Field.Undefined));

GanttBarStyle style3 = view.CustomBarStyles[2];
Console.WriteLine("Style3.LeftField is TaskPercentComplete : {0}", style3.LeftField.Equals(Field.TaskPercentComplete));
Console.WriteLine("Style3.RightField is TaskPercentWorkComplete : {0}", style3.RightField.Equals(Field.TaskPercentWorkComplete));
Console.WriteLine("Style3.TopField is Field.TaskActive : {0}", style3.TopField.Equals(Field.TaskActive));
Console.WriteLine("Style3.BottomField is TaskActualCost : {0}", style3.BottomField.Equals(Field.TaskActualCost));
Console.WriteLine("Style3.InsideField is Field.TaskActualDuration : {0}", style3.InsideField.Equals(Field.TaskActualDuration));

Console.WriteLine("Style3.StartShape is HouseDown : {0}", style3.StartShape.Equals(GanttBarEndShape.HouseDown));
Console.WriteLine("Style3.StartShapeType is Framed : {0}", style3.StartShapeType.Equals(GanttBarType.Framed));
Console.WriteLine("Style3.StartShapeColor is Red : {0}", style3.StartShapeColor.Equals(Color.FromArgb(Color.Red.ToArgb())));

Console.WriteLine("Style3.EndShape is CircleDiamond : {0}", style3.EndShape.Equals(GanttBarEndShape.CircleDiamond));
Console.WriteLine("Style3.EndShapeType is Solid : {0}",  style3.EndShapeType.Equals(GanttBarType.Solid) );
Console.WriteLine("Style3.EndShapeColor is Yellow : {0}",  style3.EndShapeColor.Equals(Color.FromArgb(Color.Yellow.ToArgb())));

Console.WriteLine("Style3.MiddleShape is RectangleTop : {0}", style3.MiddleShape.Equals(GanttBarMiddleShape.RectangleTop));
Console.WriteLine("Style3.MiddleFillPattern is SolidFill : {0}", style3.MiddleFillPattern.Equals(GanttBarFillPattern.SolidFill));
Console.WriteLine("Style3.EndShapeColor is Red : {0}", style3.MiddleShapeColor.Equals(Color.FromArgb(Color.Red.ToArgb())));

Загальні випадки використання

Стилі користувацьких стовпчиків зазвичай використовуються для:

• Візуального розрізнення етапів, критичних завдань або підсумкових завдань.
• Застосування кольорового кодування для різних команд або відділів.
• Динамічного позначення завдань на основі користувацьких полів (Text1, ResourceNames тощо).
• Виділяйте відкладені завдання унікальними кольорами або фігурами.

Підсумок

Aspose.Tasks для .NET забезпечує повний контроль над тим, як завдання візуалізуються на діаграмах Ганта, за допомогою класу GanttBarStyle. Незалежно від того, чи створюєте ви новий звіт, чи копіюєте вивід Microsoft Project, API дозволяє точно контролювати фігури, кольори, текстові підписи та логіку стилізації.