ガントチャートのレンダリング

概要

ガントチャートは、プロジェクトのスケジュール、タスク階層、期間、依存関係を視覚化するために広く使用されています。 .NETのAspose.Tasksにより、開発者はGANTTチャートをプログラムでJPEG、PNG、BMP、またはMultipage TIFFなどのイメージ形式にレンダリングし、レイアウト、色、ラベル、タイムスケール、バースタイルの高度なカスタマイズをサポートします。

Microsoft Projectを使用すると、ユーザーはガントチャートが表示されるタイムスケールを設定できます。(タイムスケールはガントチャートビューの上部に示されています)。

.NETのAspose.tasksはこの機能をサポートし、異なるタイムスケール設定でガントチャートをレンダリングできます。ガントチャートは、これらのオプションを使用して1ページの画像にレンダリングできます。

サポートされている出力形式

ガントチャートは次のようにエクスポートできます。

• JPEG/PNG/BMP - ドキュメントまたはレポートに埋め込むため
• tiff(multipage) - 印刷またはアーカイブ用
• PDF - レポートスタイルのレンダリングに「PDFSaveOptions」を使用します

典型的なユースケースには以下が含まれます。

• 内部ダッシュボードまたはレポートエンジンとの統合
• 利害関係者向けの印刷対応のビジュアル
• 監査目的でプロジェクトのアーカイブ状態

タイムスケールの設定と画像への保存

ImagesAveoptionsクラスのタイムスケールプロパティは、プロジェクトのタイムスケール設定を決定します。タイムスケールはデフォルトで日に設定されます。他のオプションは月と3ヶ月の3番目です。

次のコードサンプル：

1. プロジェクトファイルを読み取ります。
2. それぞれの異なるタイムスケール設定を設定します。
3. ファイルをJPGとしてディスクに保存します。

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

// Save to one page image (Timescale.days by default)
project.Save("NewProductDevDays.jpeg", new ImageSaveOptions(SaveFileFormat.JPEG));

// Save to one page image (Timescale.ThirdsOfMonths)
ImageSaveOptions options = new ImageSaveOptions(SaveFileFormat.JPEG);
options.Timescale = Timescale.ThirdsOfMonths;

project.Save("NewProductDevThirdsOfMonths.jpeg", options);

// Save to one page image (Timescale.Months)
options.Timescale = Timescale.Months;
project.Save("NewProductDevMonths.jpeg", options);

Key Rendering Settings

Property	Description
ImageSaveOptions.Timescale	Defines timeline scale (Days, Months, etc.)
RollUpGanttBars	Enables rolled-up summary bars
DrawNonWorkingTime	Toggles rendering of non-working hours/days
TextFormatter	Customizes task labels dynamically
StringAlignment	Controls alignment of text in columns
UseGradientBrush	Enables MS Project–like gradient fill

Rolling Up Gantt Bars During Rendering

• If the SaveOptions.RollUpGanttBars property is set to true, any summary task in the project is marked by its visible subtasks, keeping into account the Task.HideBar property when rendering. (If Task.HideBar = true, the bar is not rendered on the Gantt chart.)
• If SaveOptions.RollUpGanttBars = false, the subtask will be shown on the summary task anyway, provided that subtask.IsRollup and subtask.ParentTask.IsRollup are set to true.

Also, if SaveOptions.DrawNonWorkingTime (default value = true) is set to false, non-working time will not be shown on the Gantt chart.

Example 1: Gantt Chart Bars Not Rolled Up

PdfSaveOptions options = new PdfSaveOptions();
options.PresentationFormat = PresentationFormat.GanttChart;
options.FitContent = true;
options.RollUpGanttBars = false;
options.DrawNonWorkingTime = false;
options.PageSize = PageSize.A3;
Project project = new Project(file);
project.Save("RenderGanttChartWithBarsNotRolledUp_out.pdf", (SaveOptions)options);

The output from example 1

Example 2: Rolling Up Gantt Chart Bars

In this example, SaveOptions.RollUpGanttBars = true, SaveOptions.DrawNonWorkingTime = true, and task.HideBar = false for hidden tasks.

PdfSaveOptions options = new PdfSaveOptions();
options.PresentationFormat = PresentationFormat.GanttChart;
options.FitContent = true;
options.RollUpGanttBars = true;
options.DrawNonWorkingTime = true;
options.PageSize = PageSize.A3;

Project project = new Project(fileName);
project.Save("RenderGanttChartWithBarsNotRolledUp_out.pdf", (SaveOptions)options);

The output from example 2

Customize Text with Task Bars

In this example, the text on the right of the taskbar can be customized by delegate instance. Here we customize the text on the critical tasks.

Project project = new Project();

Task task1 = project.RootTask.Children.Add("Task 1");
Task task2 = project.RootTask.Children.Add("Task 2");

task1.Set(Tsk.Duration, project.GetDuration(1, TimeUnitType.Day));
task2.Set(Tsk.Duration, project.GetDuration(1, TimeUnitType.Day));

TaskLink link = project.TaskLinks.Add(task1, task2, TaskLinkType.FinishToStart);

Task task3 = project.RootTask.Children.Add("Task 3");
Resource resource1 = project.Resources.Add("Resource 1");
Resource resource2 = project.Resources.Add("Resource 2");
Resource resource3 = project.Resources.Add("Resource 3");

ResourceAssignment assignment1 = project.ResourceAssignments.Add(task1, resource1);
ResourceAssignment assignment2 = project.ResourceAssignments.Add(task2, resource2);
ResourceAssignment assignment3 = project.ResourceAssignments.Add(task3, resource3);

SaveOptions options = new PdfSaveOptions();
options.Timescale = Timescale.ThirdsOfMonths;

BarStyle style = new BarStyle();
style.ItemType = BarItemType.CriticalTask;

style.BarTextConverter = delegate (Task t)
{
  return string.Format("This task is on critical path");
};

BarStyle style2 = new BarStyle();
style2.BarColor = Color.DarkOrchid;
style2.ItemType = BarItemType.Task;

options.BarStyles = new List<BarStyle>();
options.BarStyles.Add(style);
options.BarStyles.Add(style2);

project.Save("output.pdf", options);

Align Cell Contents

Text can be aligned by GanttChartColumn.StringAlignment, ResourceViewColumn.StringAlignment properties. Alignment by default is StringAlignment.Near (left).

Project project = new Project("New Project.mpp");
SaveOptions options = new PdfSaveOptions();
options.Timescale = Timescale.Months;
options.View = ProjectView.GetDefaultGanttChartView();

GanttChartColumn column1 = options.View.Columns[2] as GanttChartColumn;
column1.StringAlignment = StringAlignment.Center;
column1 = options.View.Columns[3] as GanttChartColumn;
column1.StringAlignment = StringAlignment.Far;
column1 = options.View.Columns[4] as GanttChartColumn;
column1.StringAlignment = StringAlignment.Far;

project.Save("AlignCellContents_GanttChart_out.pdf", options);

options.PresentationFormat = PresentationFormat.ResourceSheet;
options.View = ProjectView.GetDefaultResourceSheetView();

ResourceViewColumn column2 = options.View.Columns[2] as ResourceViewColumn;
column2.StringAlignment = StringAlignment.Center;
column2 = options.View.Columns[3] as ResourceViewColumn;
column2.StringAlignment = StringAlignment.Far;
column2 = options.View.Columns[4] as ResourceViewColumn;
column2.StringAlignment = StringAlignment.Far;

project.Save("AlignCellContents_ResourceSheet_out.pdf", options);

Changing Gantt Chart Bars Color Gradient

Microsoft Project allows users to render the output of Gantt charts using gradients. The same functionality is provided by Aspose.Tasks as shown in the following sample code.

Project project = new Project("New Project.mpp");
SaveOptions options = new XamlOptions();
options.UseGradientBrush = false;
project.Save("ChangeGanttBarsColorGradient_Solid_out.xaml", options);

options.UseGradientBrush = true;
project.Save("ChangeGanttBarsColorGradient_Gradient_out.xaml", options);

Setting Start date of Gantt Chart View

The TimeScaleStart property exposed by Prj class allows to set the start date of the Gantt chart view. However, if the saved file is opened by MSP in maximized window mode then the timescale start date will not match.

Project project = new Project("New Project.mpp");
project.Set(Prj.TimescaleStart, new DateTime(2012, 4, 30));
project.Save("SetGanttChartViewStartDate_out.mpp", SaveFileFormat.MPP);

Aspose.Tasks for .NET provides comprehensive capabilities for exporting Gantt charts with full control over layout, style, and visual logic. Whether you’re generating visual reports, printing schedules, or embedding task data into dashboards — the flexible rendering engine supports your use case.

You can further explore:

• Render Project to PDF
• Working with Views
• Render Project to Multipage TIFF