Arbeiten mit benutzerdefinierten Barstilen

Überblick

In Microsoft Project können Benutzer die Visualisierung von benutzerdefinierten Balken -Styles definieren, um die Visualisierung zu verbessern oder bestimmte Arten von Aufgaben hervorzuheben. Dies beinhaltet das Ändern des Aussehens von Balken (Start, Mitte, Ende), Hinzufügen von benutzerdefinierten Farben, Anpassung Formen und Konfigurieren Textbezeichnungen Um Aufgabenbalken.

Aspose.Tasks FÜR .NET unterstützt diese Anpassungsstufe über die “GanttBarStyle” -Klasse. Damit können Entwickler programmgesteuert steuern, wie jede Aufgabe (oder Gruppe von Aufgaben) im renderierten Gantt -Diagramm -Bild angezeigt wird, wodurch Berichterstattung und visuelle Analyse aussagekräftiger werden.

Definieren eines benutzerdefinierten Barstils

Um einen neuen Stil für eine bestimmte Aufgabe oder eine bestimmte Aufgabe zu definieren, müssen Sie:

1. Erstellen Sie eine neue Instanz von ganttbarstyle.
2. Setzen Sie Eigenschaften wie “ShowFortaskuid”, “Middleshape”, “startshape”, “endshape”, “fillcolor” und andere.
3. Fügen Sie den Stil der Kollektion “ImagesSaveOptions.Barstyles” hinzu, bevor Sie sie rendern.

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

Beispiel: Wenden Sie den benutzerdefinierten Stil auf eine bestimmte Aufgabe an

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())));

Häufige Anwendungsfälle

Benutzerdefinierte Balkenstile werden häufig verwendet, um:

• Meilensteine, kritische Aufgaben oder Zusammenfassungsaufgaben optisch hervorzuheben.
• Farbcodierung für verschiedene Teams oder Abteilungen.
• Aufgaben dynamisch anhand benutzerdefinierter Felder (Text1, Ressourcennamen usw.) zu kennzeichnen.
• Verspätete Aufgaben durch einzigartige Farben oder Formen hervorzuheben.

Zusammenfassung

Aspose.Tasks für .NET bietet über die Klasse „GanttBarStyle“ die volle Kontrolle über die Visualisierung von Aufgaben in Gantt-Diagrammen. Ob Sie einen neuen Bericht erstellen oder Microsoft Project-Ausgaben replizieren – die API ermöglicht die präzise Steuerung von Formen, Farben, Textbeschriftungen und Stillogik.