カスタムバースタイルを使用します

概要

Microsoft Projectでは、Ganttチャートビューでは、ユーザーはカスタムバースタイルを定義して視覚化を改善したり、特定のタイプのタスクを強調したりできます。これには、バーの外観(スタート、ミドル、エンド)の変更、カスタムカラーの追加、シェイプの調整、およびタスクバーの上にテキストラベルの構成が含まれます。

.NETのAspose.Tasksは、 ganttbarstyleクラスを介してこのレベルのカスタマイズをサポートしています。これにより、開発者は、各タスク(またはタスクのグループ)がレンダリングされたガントチャート画像に表示される方法をプログラム的に制御でき、レポートと視覚分析をより意味のあるものにします。

カスタムバースタイルの定義

特定のタスクまたは一連のタスクの新しいスタイルを定義するには、次のことが必要です。

1. 「ganttbarstyle」の新しいインスタンスを作成します。
2. 「showfortaskuid」、「middlesshape」、「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())));

一般的なユースケース

カスタムバースタイルは、主に以下の目的で使用されます。

• マイルストーン、クリティカルタスク、またはサマリータスクを視覚的に区別する。
• チームや部門ごとに色分けを適用する。
• カスタムフィールド (Text1、ResourceNames など) に基づいて、タスクに動的にラベルを付ける。
• 遅延タスク を独自の色や図形で強調表示する。

概要

Aspose.Tasks for .NET は、GanttBarStyle クラスを使用して、ガントチャートにおけるタスクの表示方法を完全に制御できます。新しいレポートを作成する場合でも、Microsoft Project の出力を複製する場合でも、API を使用することで、図形、色、テキストラベル、スタイル設定ロジックを詳細に制御できます。