Renderizando gráficos Gantt

Descripción general

Los gráficos Gantt se utilizan ampliamente para visualizar los horarios de los proyectos, las jerarquías de tareas, las duraciones y las dependencias. Aspose.Tasks for .NET permite a los desarrolladores hacer medidas medias programáticas a formatos de imagen como JPEG, PNG, BMP o TIFF multipage, admitiendo la personalización avanzada de diseño, colores, etiquetas, escala de tiempo y estilos de barra.

Microsoft Project permite a los usuarios establecer la escala de tiempo en la que se muestra un grado de Gantt.

Aspose.Tasks para .NET admite esta función y le permite representar gráficos Gantt con diferentes configuraciones de escala de tiempo. Los gráficos Gantt se pueden representar a la imagen de una página utilizando estas opciones.

Formatos de salida compatibles

Los gráficos de Gantt se pueden exportar a:

• jpeg/png/bmp - para incrustar en documentos o informes
• tiff (multipage) - para imprimir o archivar
• PDF-Uso de pdfsaveOptions para el renderizado de estilo de informe

Los casos de uso típicos incluyen:

• Integración con paneles internos o motores de informes
• Impresos listos para la impresión para las partes interesadas
• Archivando estados del proyecto para fines de auditoría

Configuración de escalas de tiempo y guardando una imagen

La propiedad de la escala de tiempo de la clase determina la configuración de la escala de tiempo de un proyecto. La escala de tiempo se establece en días por defecto. Las otras opciones son mes y tercero de los meses.

La siguiente muestra de código:

1. Lee un archivo de proyecto.
2. Establece cada configuración de escala de tiempo diferente.
3. Guarda el archivo en el disco como 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

Agrupamiento de barras de Gantt durante la renderización

• Si la propiedad SaveOptions.RollUpGanttBars se establece en verdadero, cualquier tarea de resumen del proyecto se marcará con sus subtareas visibles, teniendo en cuenta la propiedad Task.HideBar al renderizar. (Si Task.HideBar = verdadero, la barra no se renderiza en el diagrama de Gantt).
• Si SaveOptions.RollUpGanttBars = falso, la subtarea se mostrará en la tarea de resumen de todos modos, siempre que subtask.IsRollup y subtask.ParentTask.IsRollup se establezcan en verdadero.

Además, si SaveOptions.DrawNonWorkingTime (valor predeterminado = verdadero) se establece en falso, el tiempo no laborable no se mostrará en el diagrama de Gantt.

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