커스텀 바 스타일로 작업합니다

개요

Microsoft Project에서 Gantt 차트보기를 통해 사용자는 사용자 정의 막대 스타일를 정의하여 시각화를 개선하거나 특정 유형의 작업을 강조 할 수 있습니다. 여기에는 바 모양 (시작, 중간, 끝), 사용자 정의 색상 추가, 모양 조정 및 작업 표시 줄 주변의 텍스트 레이블 구성이 포함됩니다.

aspose.tasks for .net은 ‘GanttbarStyle’클래스를 통해이 수준의 사용자 정의를 지원합니다. 이를 통해 개발자는 각 작업 (또는 작업 그룹)이 렌더링 된 Gantt 차트 이미지에 표시되는 방식을 프로그래밍 방식으로 제어하여보고 및 시각적 분석을보다 의미있게 만듭니다.

맞춤형 바 스타일 정의

특정 작업 또는 작업 세트에 대한 새로운 스타일을 정의하려면 다음과 같습니다.

1. ‘GanttbarStyle’의 새 인스턴스를 만듭니다.
2. showfortaskuid,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;
}

Reading Existing Custom Bar Styles

Aspose.Tasks also allows reading the GanttBarStyle objects from existing MPP files. This can be useful if you need to analyze or replicate the styling applied in Microsoft Project.

Example: Read All Custom Styles from a 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())));

Common Use Cases

Custom bar styles are commonly used to:

• Visually distinguish milestones, critical tasks, or summary tasks.
• Apply color-coding for different teams or departments.
• Label tasks dynamically based on custom fields (Text1, ResourceNames, etc.).
• Highlight delayed tasks with unique colors or shapes.

Summary

Aspose.Tasks for .NET provides full control over how tasks are visualized in Gantt charts via the GanttBarStyle class. Whether you’re creating a new report or replicating Microsoft Project output, the API allows for precise control of shapes, colors, text labels, and styling logic.